// JoeyLib platform, CPU, endian, and capability defines.
//
// Exactly one JOEYLIB_PLATFORM_* must be defined per build. The build
// system normally sets this via -D; if absent, the header attempts to
// auto-detect from compiler-predefined macros.

#ifndef JOEYLIB_PLATFORM_H
#define JOEYLIB_PLATFORM_H

// ----- Auto-detect platform from compiler macros if not preset -----

#if !defined(JOEYLIB_PLATFORM_IIGS) && \
    !defined(JOEYLIB_PLATFORM_AMIGA) && \
    !defined(JOEYLIB_PLATFORM_ATARIST) && \
    !defined(JOEYLIB_PLATFORM_DOS) && \
    !defined(JOEYLIB_PLATFORM_BLANK)

  #if defined(__DJGPP__) || defined(__MSDOS__)
    #define JOEYLIB_PLATFORM_DOS
  #elif defined(__amigaos__) || defined(AMIGA) || defined(__amigaos4__)
    #define JOEYLIB_PLATFORM_AMIGA
  #elif defined(__atarist__) || defined(__MINT__) || defined(__TOS__)
    #define JOEYLIB_PLATFORM_ATARIST
  #elif defined(__APPLE2GS__) || defined(__GNO__)
    #define JOEYLIB_PLATFORM_IIGS
  #else
    #error "JoeyLib: unknown platform; define JOEYLIB_PLATFORM_<TARGET> explicitly via -D"
  #endif

#endif

// JOEYLIB_PLATFORM_BLANK is the copy-to-start template for a new port (see
// src/blank/blank.c). It has no auto-detect macro -- bring it up by building
// with -DJOEYLIB_PLATFORM_BLANK.

// ----- Validate exactly one platform is defined -----

#if (defined(JOEYLIB_PLATFORM_IIGS) + \
     defined(JOEYLIB_PLATFORM_AMIGA) + \
     defined(JOEYLIB_PLATFORM_ATARIST) + \
     defined(JOEYLIB_PLATFORM_DOS) + \
     defined(JOEYLIB_PLATFORM_BLANK)) != 1
  #error "JoeyLib: exactly one JOEYLIB_PLATFORM_* must be defined"
#endif

// ----- Derived CPU markers -----

#if defined(JOEYLIB_PLATFORM_IIGS)
  #define JOEYLIB_CPU_65816
  #define JOEYLIB_ENDIAN_LITTLE
  #define JOEYLIB_NATIVE_CHUNKY
  #define JOEYLIB_PLATFORM_NAME "Apple IIgs"
#elif defined(JOEYLIB_PLATFORM_AMIGA)
  #define JOEYLIB_CPU_68000
  #define JOEYLIB_ENDIAN_BIG
  #define JOEYLIB_NATIVE_PLANAR
  #define JOEYLIB_HAS_BLITTER
  #define JOEYLIB_HAS_COPPER
  #define JOEYLIB_PLATFORM_NAME "Commodore Amiga"
#elif defined(JOEYLIB_PLATFORM_ATARIST)
  #define JOEYLIB_CPU_68000
  #define JOEYLIB_ENDIAN_BIG
  #define JOEYLIB_NATIVE_PLANAR
  #define JOEYLIB_PLATFORM_NAME "Atari ST"
#elif defined(JOEYLIB_PLATFORM_DOS)
  #define JOEYLIB_CPU_X86
  #define JOEYLIB_ENDIAN_LITTLE
  #define JOEYLIB_NATIVE_CHUNKY
  #define JOEYLIB_PLATFORM_NAME "MS-DOS"
#elif defined(JOEYLIB_PLATFORM_BLANK)
  // Chunky little-endian is the simplest baseline for a new port: the generic
  // backend gives you fully-working software rendering out of the box. Adjust
  // these (or switch to JOEYLIB_NATIVE_PLANAR) once you know your hardware.
  #define JOEYLIB_ENDIAN_LITTLE
  #define JOEYLIB_NATIVE_CHUNKY
  #define JOEYLIB_PLATFORM_NAME "Blank Template"
#endif

// ----- Per-machine op override registry (JL_HAS_<OP>) -----
//
// A machine #define-s JL_HAS_<OP> for each overridable platform op it replaces
// with its own (asm / native) implementation in src/<machine>/. Ops a machine
// does NOT claim fall back to the portable-C default in src/generic/, selected
// at compile time (no runtime dispatch). The jlp<Op> macros/prototypes in
// src/core/port.h read this table. This is the new lib's equivalent of the
// original joeylib's joey.h JL_HAS_* table.

#if defined(JOEYLIB_PLATFORM_IIGS)
  #define JL_HAS_SURFACE_CLEAR    // iigsSurfaceClearFastInner (stage), macro
  #define JL_HAS_DRAW_PIXEL       // iigsDrawPixelInner, macro
  #define JL_HAS_DRAW_LINE        // iigsDrawLineInner, macro
  #define JL_HAS_DRAW_CIRCLE      // iigsDrawCircleInner, macro
  #define JL_HAS_FILL_CIRCLE      // iigsFillCircleInner (stage), macro -- returns bool
  #define JL_HAS_FILL_RECT        // iigsFillRectInner (stage), macro -> generic else
  #define JL_HAS_TILE_FILL        // iigsTileFillInner, macro
  #define JL_HAS_TILE_COPY        // iigsTileCopyInner, macro
  #define JL_HAS_TILE_COPY_MASKED // iigsTileCopyMaskedInner, macro
  #define JL_HAS_TILE_PASTE       // iigsTilePasteInner, macro
  #define JL_HAS_TILE_SNAP        // iigsTileSnapInner, macro
  #define JL_HAS_SPRITE_DRAW      // chunky -> codegen; planes mirror is noop macro
  #define JL_HAS_SPRITE_SAVE      // noop macro (codegen path saves)
  #define JL_HAS_SPRITE_RESTORE   // noop macro
  #define JL_HAS_FLOOD_WALK_AND_SCANS // iigsFloodWalkAndScansInner (all-in-one), macro
  #define JL_HAS_BIG_ALLOC            // Memory Manager NewHandle/DisposeHandle, function
  #define JL_HAS_STAGE_ALLOC_PIXELS   // pinned $01:2000 display memory, function
  #define JL_HAS_STAGE_FREE_PIXELS    // no-op (pinned), function
  #define JL_HAS_FRAME_HZ             // runtime 50/60 from battery RAM, function
  #define JL_HAS_FRAME_COUNT          // GetTick word, function
  #define JL_HAS_WAIT_VBL             // $C019 VBL poll, function
  // audio: every real port implements the full engine
  #define JL_HAS_AUDIO_INIT
  #define JL_HAS_AUDIO_SHUTDOWN
  #define JL_HAS_AUDIO_PLAY_MOD
  #define JL_HAS_AUDIO_STOP_MOD
  #define JL_HAS_AUDIO_IS_PLAYING_MOD
  #define JL_HAS_AUDIO_PLAY_SFX
  #define JL_HAS_AUDIO_PLAY_SFX_STREAM
  #define JL_HAS_AUDIO_STOP_SFX
  #define JL_HAS_AUDIO_TONE
  #define JL_HAS_AUDIO_VOICE
  #define JL_HAS_AUDIO_TICK_REGISTER
  #define JL_HAS_AUDIO_CRITICAL_ENTER
  #define JL_HAS_AUDIO_CRITICAL_EXIT
  #define JL_HAS_AUDIO_FRAME_TICK
  // lifecycle / present / input (every real port implements)
  #define JL_HAS_INIT
  #define JL_HAS_SHUTDOWN
  #define JL_HAS_PRESENT
  #define JL_HAS_INPUT_INIT
  #define JL_HAS_INPUT_SHUTDOWN
  #define JL_HAS_INPUT_POLL
  #define JL_HAS_JOYSTICK_RESET
  // millisElapsed: generic frameCount*1000/frameHz (no override)
#elif defined(JOEYLIB_PLATFORM_AMIGA)
  #define JL_HAS_SURFACE_CLEAR    // planar clear, function
  #define JL_HAS_DRAW_PIXEL       // amigaPlanarSetPixel, function
  #define JL_HAS_DRAW_LINE        // amigaPlanarLine, function
  #define JL_HAS_DRAW_CIRCLE      // amiga planar circle, function
  #define JL_HAS_FILL_CIRCLE      // amiga planar fill circle, function -- returns bool
  #define JL_HAS_FILL_RECT        // amiga planar fill rect, function
  #define JL_HAS_TILE_FILL        // amiga planar tile fill, function
  #define JL_HAS_TILE_COPY        // amiga planar tile copy, function
  #define JL_HAS_TILE_COPY_MASKED // amiga planar masked copy, function
  #define JL_HAS_TILE_PASTE       // amiga planar tile paste, function
  #define JL_HAS_TILE_SNAP        // amiga planar tile snap, function
  #define JL_HAS_TILE_PASTE_MONO  // amiga planar mono colorize+paste, function
  #define JL_HAS_SPRITE_DRAW      // amiga planar sprite draw, function
  #define JL_HAS_SPRITE_SAVE      // amiga planar sprite save, function
  #define JL_HAS_SPRITE_RESTORE   // amiga planar sprite restore, function
  #define JL_HAS_FLOOD_WALK_PLANES     // amiga planar flood walk-out, function
  #define JL_HAS_FLOOD_SCAN_ROW_PLANES // amiga planar flood scan-row, function
  #define JL_HAS_SURFACE_COPY_PLANES   // amiga blitter plane copy, function
  #define JL_HAS_SAMPLE_PIXEL          // amiga planar nibble decode, function
  #define JL_HAS_SURFACE_HASH          // amiga planar hash, function
  #define JL_HAS_SURFACE_LOAD_FILE     // amiga planar load, function
  #define JL_HAS_SURFACE_SAVE_FILE     // amiga planar save, function
  #define JL_HAS_STAGE_ALLOC_PIXELS    // amiga: NULL (no chunky stage shadow), function
  #define JL_HAS_SURFACE_ALLOC_PIXELS  // amiga: NULL (planar storage), function
  #define JL_HAS_SURFACE_ALLOC_PORT_DATA // amiga AmigaPlanarT + chip planes, function
  #define JL_HAS_SURFACE_FREE_PORT_DATA  // amiga FreeMem planes, function
  #define JL_HAS_SURFACE_PLANE_PTR     // amiga plane base pointer, function
  #define JL_HAS_FRAME_HZ              // PAL 50, function
  #define JL_HAS_FRAME_COUNT           // VBL-server counter, function
  #define JL_HAS_WAIT_VBL              // WaitTOF, function
  // audio: every real port implements the full engine
  #define JL_HAS_AUDIO_INIT
  #define JL_HAS_AUDIO_SHUTDOWN
  #define JL_HAS_AUDIO_PLAY_MOD
  #define JL_HAS_AUDIO_STOP_MOD
  #define JL_HAS_AUDIO_IS_PLAYING_MOD
  #define JL_HAS_AUDIO_PLAY_SFX
  #define JL_HAS_AUDIO_PLAY_SFX_STREAM
  #define JL_HAS_AUDIO_STOP_SFX
  #define JL_HAS_AUDIO_TONE
  #define JL_HAS_AUDIO_VOICE
  #define JL_HAS_AUDIO_TICK_REGISTER
  #define JL_HAS_AUDIO_CRITICAL_ENTER
  #define JL_HAS_AUDIO_CRITICAL_EXIT
  #define JL_HAS_AUDIO_FRAME_TICK
  // lifecycle / present / input (every real port implements)
  #define JL_HAS_INIT
  #define JL_HAS_SHUTDOWN
  #define JL_HAS_PRESENT
  #define JL_HAS_INPUT_INIT
  #define JL_HAS_INPUT_SHUTDOWN
  #define JL_HAS_INPUT_POLL
  #define JL_HAS_JOYSTICK_RESET
  // millisElapsed: generic frameCount*1000/frameHz (no override)
#elif defined(JOEYLIB_PLATFORM_ATARIST)
  #define JL_HAS_SURFACE_CLEAR    // planar clear, function
  #define JL_HAS_DRAW_PIXEL       // stPlanarSetPixel, function
  #define JL_HAS_DRAW_LINE        // stPlanarLine, function
  #define JL_HAS_DRAW_CIRCLE      // st planar circle, function
  #define JL_HAS_FILL_CIRCLE      // st planar fill circle, function -- returns bool
  #define JL_HAS_FILL_RECT        // st planar fill rect, function
  #define JL_HAS_TILE_FILL        // st planar tile fill, function
  #define JL_HAS_TILE_COPY        // st planar tile copy, function
  #define JL_HAS_TILE_COPY_MASKED // st planar masked copy, function
  #define JL_HAS_TILE_PASTE       // st planar tile paste, function
  #define JL_HAS_TILE_SNAP        // st planar tile snap, function
  #define JL_HAS_TILE_PASTE_MONO  // st planar mono colorize+paste, function
  #define JL_HAS_SPRITE_DRAW      // st planar sprite draw, function
  #define JL_HAS_SPRITE_SAVE      // st planar sprite save, function
  #define JL_HAS_SPRITE_RESTORE   // st planar sprite restore, function
  #define JL_HAS_SURFACE_COPY_PLANES // st planar buffer memcpy, function
  #define JL_HAS_SAMPLE_PIXEL        // st planar nibble decode, function
  #define JL_HAS_SURFACE_HASH        // st planar hash, function
  #define JL_HAS_SURFACE_LOAD_FILE   // st planar load, function
  #define JL_HAS_SURFACE_SAVE_FILE   // st planar save, function
  #define JL_HAS_STAGE_ALLOC_PIXELS    // st: NULL (no chunky stage shadow), function
  #define JL_HAS_SURFACE_ALLOC_PIXELS  // st: NULL (planar storage), function
  #define JL_HAS_SURFACE_ALLOC_PORT_DATA // st StPlanarT + interleaved buffer, function
  #define JL_HAS_SURFACE_FREE_PORT_DATA  // st free buffer, function
  #define JL_HAS_SURFACE_PLANE_PTR   // st interleaved buffer base, function
  #define JL_HAS_FRAME_HZ            // PAL 50, function
  #define JL_HAS_FRAME_COUNT         // VBL-ISR counter, function
  #define JL_HAS_WAIT_VBL            // frame-counter wait, function
  #define JL_HAS_MILLIS_ELAPSED      // Supexec 200 Hz tick, function
  // audio: every real port implements the full engine
  #define JL_HAS_AUDIO_INIT
  #define JL_HAS_AUDIO_SHUTDOWN
  #define JL_HAS_AUDIO_PLAY_MOD
  #define JL_HAS_AUDIO_STOP_MOD
  #define JL_HAS_AUDIO_IS_PLAYING_MOD
  #define JL_HAS_AUDIO_PLAY_SFX
  #define JL_HAS_AUDIO_PLAY_SFX_STREAM
  #define JL_HAS_AUDIO_STOP_SFX
  #define JL_HAS_AUDIO_TONE
  #define JL_HAS_AUDIO_VOICE
  #define JL_HAS_AUDIO_TICK_REGISTER
  #define JL_HAS_AUDIO_CRITICAL_ENTER
  #define JL_HAS_AUDIO_CRITICAL_EXIT
  #define JL_HAS_AUDIO_FRAME_TICK
  // lifecycle / present / input (every real port implements)
  #define JL_HAS_INIT
  #define JL_HAS_SHUTDOWN
  #define JL_HAS_PRESENT
  #define JL_HAS_INPUT_INIT
  #define JL_HAS_INPUT_SHUTDOWN
  #define JL_HAS_INPUT_POLL
  #define JL_HAS_JOYSTICK_RESET
#elif defined(JOEYLIB_PLATFORM_DOS)
  // chunky generics: surface clear, draw pixel/line/circle, fill circle/rect,
  // tiles, surface readers, allocation -- DOS overrides only the timing services.
  #define JL_HAS_FRAME_HZ            // VGA ~70, function
  #define JL_HAS_FRAME_COUNT         // $3DA retrace edge counter, function
  #define JL_HAS_WAIT_VBL            // $3DA retrace poll, function
  #define JL_HAS_MILLIS_ELAPSED      // uclock / audio-ISR tick, function
  // audio: every real port implements the full engine
  #define JL_HAS_AUDIO_INIT
  #define JL_HAS_AUDIO_SHUTDOWN
  #define JL_HAS_AUDIO_PLAY_MOD
  #define JL_HAS_AUDIO_STOP_MOD
  #define JL_HAS_AUDIO_IS_PLAYING_MOD
  #define JL_HAS_AUDIO_PLAY_SFX
  #define JL_HAS_AUDIO_PLAY_SFX_STREAM
  #define JL_HAS_AUDIO_STOP_SFX
  #define JL_HAS_AUDIO_TONE
  #define JL_HAS_AUDIO_VOICE
  #define JL_HAS_AUDIO_TICK_REGISTER
  #define JL_HAS_AUDIO_CRITICAL_ENTER
  #define JL_HAS_AUDIO_CRITICAL_EXIT
  #define JL_HAS_AUDIO_FRAME_TICK
  // lifecycle / present / input (every real port implements)
  #define JL_HAS_INIT
  #define JL_HAS_SHUTDOWN
  #define JL_HAS_PRESENT
  #define JL_HAS_INPUT_INIT
  #define JL_HAS_INPUT_SHUTDOWN
  #define JL_HAS_INPUT_POLL
  #define JL_HAS_JOYSTICK_RESET
#elif defined(JOEYLIB_PLATFORM_BLANK)
  // Copy-to-start template. It overrides ONLY the platform SERVICES (TODO
  // stubs in src/blank/blank.c). Everything graphical -- draw / tile / sprite
  // primitives, surface readers, allocation, bigAlloc, millisElapsed -- comes
  // from the portable-C generics for free, so a chunky port renders correctly
  // before you write a line of graphics code. Add a JL_HAS_<OP> here + an
  // override in blank.c only when you want to accelerate a specific op.
  #define JL_HAS_INIT            // bring up your display mode
  #define JL_HAS_SHUTDOWN        // restore it
  #define JL_HAS_PRESENT         // blit the chunky stage to your framebuffer
  #define JL_HAS_INPUT_INIT
  #define JL_HAS_INPUT_SHUTDOWN
  #define JL_HAS_INPUT_POLL      // read your keyboard into gKeyState[]
  #define JL_HAS_JOYSTICK_RESET
  #define JL_HAS_WAIT_VBL        // pace to the display
  #define JL_HAS_FRAME_COUNT     // a monotonic frame/refresh counter
  #define JL_HAS_FRAME_HZ        // your refresh rate in Hz
  // audio: left to the no-op generics (your port links + runs silent). Add
  //   JL_HAS_AUDIO_* + overrides in blank.c when you wire up sound.
#endif

// ----- Library version -----

#define JOEYLIB_VERSION_MAJOR 1
#define JOEYLIB_VERSION_MINOR 0
#define JOEYLIB_VERSION_PATCH 0
#define JOEYLIB_VERSION_STRING "1.0.0"

#endif