rbsdl3 0.1.0

data/lib/rbsdl3/ttf.rb

@@ -0,0 +1,254 @@
+# frozen_string_literal: true
+require_relative "../rbsdl3"
+require_relative "sdl"
+
+module SDL3
+  using BindingsRefinement
+  SDL_ttf = proc {
+    # Ruby wrappers for SDL_ttf macros
+    #
+    const_set :SDL_TTF_MAJOR_VERSION, 3
+    const_set :SDL_TTF_MINOR_VERSION, 2
+    const_set :SDL_TTF_MICRO_VERSION, 2
+    const_set :SDL_TTF_VERSION, SDL_VERSIONNUM(SDL_TTF_MAJOR_VERSION, SDL_TTF_MINOR_VERSION, SDL_TTF_MICRO_VERSION)
+    module_function def SDL_TTF_VERSION_ATLEAST(x, y, z) = ((SDL_TTF_MAJOR_VERSION >= x) && (SDL_TTF_MAJOR_VERSION > x || SDL_TTF_MINOR_VERSION >= y) && (SDL_TTF_MAJOR_VERSION > x || SDL_TTF_MINOR_VERSION > y || SDL_TTF_MICRO_VERSION >= z))
+
+    # Fiddle declarations for SDL_ttf functions, structs, and enums
+    #
+    extern "int TTF_Version(void)"
+    extern "void TTF_GetFreeTypeVersion(int *, int *, int *)"
+    extern "void TTF_GetHarfBuzzVersion(int *, int *, int *)"
+    extern "bool TTF_Init(void)"
+    extern "TTF_Font * TTF_OpenFont(char *, float)"
+    extern "TTF_Font * TTF_OpenFontIO(SDL_IOStream *, bool, float)"
+    extern "TTF_Font * TTF_OpenFontWithProperties(SDL_PropertiesID)"
+    extern "TTF_Font * TTF_CopyFont(TTF_Font *)"
+    extern "SDL_PropertiesID TTF_GetFontProperties(TTF_Font *)"
+    extern "Uint32 TTF_GetFontGeneration(TTF_Font *)"
+    extern "bool TTF_AddFallbackFont(TTF_Font *, TTF_Font *)"
+    extern "void TTF_RemoveFallbackFont(TTF_Font *, TTF_Font *)"
+    extern "void TTF_ClearFallbackFonts(TTF_Font *)"
+    extern "bool TTF_SetFontSize(TTF_Font *, float)"
+    extern "bool TTF_SetFontSizeDPI(TTF_Font *, float, int, int)"
+    extern "float TTF_GetFontSize(TTF_Font *)"
+    extern "bool TTF_GetFontDPI(TTF_Font *, int *, int *)"
+    typealias "TTF_FontStyleFlags", "Uint32"
+    extern "void TTF_SetFontStyle(TTF_Font *, TTF_FontStyleFlags)"
+    extern "TTF_FontStyleFlags TTF_GetFontStyle(TTF_Font *)"
+    extern "bool TTF_SetFontOutline(TTF_Font *, int)"
+    extern "int TTF_GetFontOutline(TTF_Font *)"
+    const_set :TTF_HINTING_INVALID, 4294967295
+    const_set :TTF_HINTING_NORMAL, 0
+    const_set :TTF_HINTING_LIGHT, 1
+    const_set :TTF_HINTING_MONO, 2
+    const_set :TTF_HINTING_NONE, 3
+    const_set :TTF_HINTING_LIGHT_SUBPIXEL, 4
+    typealias "TTF_HintingFlags", "enum"
+    extern "void TTF_SetFontHinting(TTF_Font *, TTF_HintingFlags)"
+    extern "int TTF_GetNumFontFaces(TTF_Font *)"
+    extern "TTF_HintingFlags TTF_GetFontHinting(TTF_Font *)"
+    extern "bool TTF_SetFontSDF(TTF_Font *, bool)"
+    extern "bool TTF_GetFontSDF(TTF_Font *)"
+    extern "int TTF_GetFontWeight(TTF_Font *)"
+    const_set :TTF_HORIZONTAL_ALIGN_INVALID, 4294967295
+    const_set :TTF_HORIZONTAL_ALIGN_LEFT, 0
+    const_set :TTF_HORIZONTAL_ALIGN_CENTER, 1
+    const_set :TTF_HORIZONTAL_ALIGN_RIGHT, 2
+    typealias "TTF_HorizontalAlignment", "enum"
+    extern "void TTF_SetFontWrapAlignment(TTF_Font *, TTF_HorizontalAlignment)"
+    extern "TTF_HorizontalAlignment TTF_GetFontWrapAlignment(TTF_Font *)"
+    extern "int TTF_GetFontHeight(TTF_Font *)"
+    extern "int TTF_GetFontAscent(TTF_Font *)"
+    extern "int TTF_GetFontDescent(TTF_Font *)"
+    extern "void TTF_SetFontLineSkip(TTF_Font *, int)"
+    extern "int TTF_GetFontLineSkip(TTF_Font *)"
+    extern "void TTF_SetFontKerning(TTF_Font *, bool)"
+    extern "bool TTF_GetFontKerning(TTF_Font *)"
+    extern "bool TTF_FontIsFixedWidth(TTF_Font *)"
+    extern "bool TTF_FontIsScalable(TTF_Font *)"
+    extern "char * TTF_GetFontFamilyName(TTF_Font *)"
+    extern "char * TTF_GetFontStyleName(TTF_Font *)"
+    const_set :TTF_DIRECTION_INVALID, 0
+    const_set :TTF_DIRECTION_LTR, 4
+    const_set :TTF_DIRECTION_RTL, 5
+    const_set :TTF_DIRECTION_TTB, 6
+    const_set :TTF_DIRECTION_BTT, 7
+    typealias "TTF_Direction", "enum"
+    extern "bool TTF_SetFontDirection(TTF_Font *, TTF_Direction)"
+    extern "TTF_Direction TTF_GetFontDirection(TTF_Font *)"
+    extern "Uint32 TTF_StringToTag(char *)"
+    extern "void TTF_TagToString(Uint32, char *, size_t)"
+    extern "bool TTF_SetFontScript(TTF_Font *, Uint32)"
+    extern "Uint32 TTF_GetFontScript(TTF_Font *)"
+    extern "Uint32 TTF_GetGlyphScript(Uint32)"
+    extern "bool TTF_SetFontLanguage(TTF_Font *, char *)"
+    extern "bool TTF_FontHasGlyph(TTF_Font *, Uint32)"
+    const_set :TTF_IMAGE_INVALID, 0
+    const_set :TTF_IMAGE_ALPHA, 1
+    const_set :TTF_IMAGE_COLOR, 2
+    const_set :TTF_IMAGE_SDF, 3
+    typealias "TTF_ImageType", "enum"
+    extern "SDL_Surface * TTF_GetGlyphImage(TTF_Font *, Uint32, TTF_ImageType *)"
+    extern "SDL_Surface * TTF_GetGlyphImageForIndex(TTF_Font *, Uint32, TTF_ImageType *)"
+    extern "bool TTF_GetGlyphMetrics(TTF_Font *, Uint32, int *, int *, int *, int *, int *)"
+    extern "bool TTF_GetGlyphKerning(TTF_Font *, Uint32, Uint32, int *)"
+    extern "bool TTF_GetStringSize(TTF_Font *, char *, size_t, int *, int *)"
+    extern "bool TTF_GetStringSizeWrapped(TTF_Font *, char *, size_t, int, int *, int *)"
+    extern "bool TTF_MeasureString(TTF_Font *, char *, size_t, int, int *, size_t *)"
+    extern "SDL_Surface * TTF_RenderText_Solid(TTF_Font *, char *, size_t, SDL_Color)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderText_Solid()"
+    extern "SDL_Surface * TTF_RenderText_Solid_Wrapped(TTF_Font *, char *, size_t, SDL_Color, int)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderText_Solid_Wrapped()"
+    extern "SDL_Surface * TTF_RenderGlyph_Solid(TTF_Font *, Uint32, SDL_Color)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderGlyph_Solid()"
+    extern "SDL_Surface * TTF_RenderText_Shaded(TTF_Font *, char *, size_t, SDL_Color, SDL_Color)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderText_Shaded()"
+    extern "SDL_Surface * TTF_RenderText_Shaded_Wrapped(TTF_Font *, char *, size_t, SDL_Color, SDL_Color, int)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderText_Shaded_Wrapped()"
+    extern "SDL_Surface * TTF_RenderGlyph_Shaded(TTF_Font *, Uint32, SDL_Color, SDL_Color)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderGlyph_Shaded()"
+    extern "SDL_Surface * TTF_RenderText_Blended(TTF_Font *, char *, size_t, SDL_Color)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderText_Blended()"
+    extern "SDL_Surface * TTF_RenderText_Blended_Wrapped(TTF_Font *, char *, size_t, SDL_Color, int)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderText_Blended_Wrapped()"
+    extern "SDL_Surface * TTF_RenderGlyph_Blended(TTF_Font *, Uint32, SDL_Color)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderGlyph_Blended()"
+    extern "SDL_Surface * TTF_RenderText_LCD(TTF_Font *, char *, size_t, SDL_Color, SDL_Color)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderText_LCD()"
+    extern "SDL_Surface * TTF_RenderText_LCD_Wrapped(TTF_Font *, char *, size_t, SDL_Color, SDL_Color, int)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderText_LCD_Wrapped()"
+    extern "SDL_Surface * TTF_RenderGlyph_LCD(TTF_Font *, Uint32, SDL_Color, SDL_Color)", unsupported: "SDL function unsupported by Fiddle: TTF_RenderGlyph_LCD()"
+    const_set :TTF_Text, struct(
+      [
+        "char *text",
+        "int num_lines",
+        "int refcount",
+        "TTF_TextData *internal",
+      ]
+    )
+    extern "TTF_TextEngine * TTF_CreateSurfaceTextEngine(void)"
+    extern "bool TTF_DrawSurfaceText(TTF_Text *, int, int, SDL_Surface *)"
+    extern "void TTF_DestroySurfaceTextEngine(TTF_TextEngine *)"
+    extern "TTF_TextEngine * TTF_CreateRendererTextEngine(SDL_Renderer *)"
+    extern "TTF_TextEngine * TTF_CreateRendererTextEngineWithProperties(SDL_PropertiesID)"
+    extern "bool TTF_DrawRendererText(TTF_Text *, float, float)"
+    extern "void TTF_DestroyRendererTextEngine(TTF_TextEngine *)"
+    extern "TTF_TextEngine * TTF_CreateGPUTextEngine(SDL_GPUDevice *)"
+    extern "TTF_TextEngine * TTF_CreateGPUTextEngineWithProperties(SDL_PropertiesID)"
+    const_set :TTF_GPUAtlasDrawSequence, struct(
+      [
+        "SDL_GPUTexture *atlas_texture",
+        "SDL_FPoint *xy",
+        "SDL_FPoint *uv",
+        "int num_vertices",
+        "int *indices",
+        "int num_indices",
+        "TTF_ImageType image_type",
+        "TTF_GPUAtlasDrawSequence *next",
+      ]
+    )
+    extern "TTF_GPUAtlasDrawSequence * TTF_GetGPUTextDrawData(TTF_Text *)"
+    extern "void TTF_DestroyGPUTextEngine(TTF_TextEngine *)"
+    const_set :TTF_GPU_TEXTENGINE_WINDING_INVALID, 4294967295
+    const_set :TTF_GPU_TEXTENGINE_WINDING_CLOCKWISE, 0
+    const_set :TTF_GPU_TEXTENGINE_WINDING_COUNTER_CLOCKWISE, 1
+    typealias "TTF_GPUTextEngineWinding", "enum"
+    extern "void TTF_SetGPUTextEngineWinding(TTF_TextEngine *, TTF_GPUTextEngineWinding)"
+    extern "TTF_GPUTextEngineWinding TTF_GetGPUTextEngineWinding(TTF_TextEngine *)"
+    extern "TTF_Text * TTF_CreateText(TTF_TextEngine *, TTF_Font *, char *, size_t)"
+    extern "SDL_PropertiesID TTF_GetTextProperties(TTF_Text *)"
+    extern "bool TTF_SetTextEngine(TTF_Text *, TTF_TextEngine *)"
+    extern "TTF_TextEngine * TTF_GetTextEngine(TTF_Text *)"
+    extern "bool TTF_SetTextFont(TTF_Text *, TTF_Font *)"
+    extern "TTF_Font * TTF_GetTextFont(TTF_Text *)"
+    extern "bool TTF_SetTextDirection(TTF_Text *, TTF_Direction)"
+    extern "TTF_Direction TTF_GetTextDirection(TTF_Text *)"
+    extern "bool TTF_SetTextScript(TTF_Text *, Uint32)"
+    extern "Uint32 TTF_GetTextScript(TTF_Text *)"
+    extern "bool TTF_SetTextColor(TTF_Text *, Uint8, Uint8, Uint8, Uint8)"
+    extern "bool TTF_SetTextColorFloat(TTF_Text *, float, float, float, float)"
+    extern "bool TTF_GetTextColor(TTF_Text *, Uint8 *, Uint8 *, Uint8 *, Uint8 *)"
+    extern "bool TTF_GetTextColorFloat(TTF_Text *, float *, float *, float *, float *)"
+    extern "bool TTF_SetTextPosition(TTF_Text *, int, int)"
+    extern "bool TTF_GetTextPosition(TTF_Text *, int *, int *)"
+    extern "bool TTF_SetTextWrapWidth(TTF_Text *, int)"
+    extern "bool TTF_GetTextWrapWidth(TTF_Text *, int *)"
+    extern "bool TTF_SetTextWrapWhitespaceVisible(TTF_Text *, bool)"
+    extern "bool TTF_TextWrapWhitespaceVisible(TTF_Text *)"
+    extern "bool TTF_SetTextString(TTF_Text *, char *, size_t)"
+    extern "bool TTF_InsertTextString(TTF_Text *, int, char *, size_t)"
+    extern "bool TTF_AppendTextString(TTF_Text *, char *, size_t)"
+    extern "bool TTF_DeleteTextString(TTF_Text *, int, int)"
+    extern "bool TTF_GetTextSize(TTF_Text *, int *, int *)"
+    typealias "TTF_SubStringFlags", "Uint32"
+    const_set :TTF_SubString, struct(
+      [
+        "TTF_SubStringFlags flags",
+        "int offset",
+        "int length",
+        "int line_index",
+        "int cluster_index",
+        { "rect": SDL_Rect },
+      ]
+    )
+    extern "bool TTF_GetTextSubString(TTF_Text *, int, TTF_SubString *)"
+    extern "bool TTF_GetTextSubStringForLine(TTF_Text *, int, TTF_SubString *)"
+    extern "TTF_SubString ** TTF_GetTextSubStringsForRange(TTF_Text *, int, int, int *)"
+    extern "bool TTF_GetTextSubStringForPoint(TTF_Text *, int, int, TTF_SubString *)"
+    extern "bool TTF_GetPreviousTextSubString(TTF_Text *, TTF_SubString *, TTF_SubString *)"
+    extern "bool TTF_GetNextTextSubString(TTF_Text *, TTF_SubString *, TTF_SubString *)"
+    extern "bool TTF_UpdateText(TTF_Text *)"
+    extern "void TTF_DestroyText(TTF_Text *)"
+    extern "void TTF_CloseFont(TTF_Font *)"
+    extern "void TTF_Quit(void)"
+    extern "int TTF_WasInit(void)"
+    const_set :TTF_DRAW_COMMAND_NOOP, 0
+    const_set :TTF_DRAW_COMMAND_FILL, 1
+    const_set :TTF_DRAW_COMMAND_COPY, 2
+    typealias "TTF_DrawCommand", "enum"
+    const_set :TTF_FillOperation, struct(
+      [
+        "TTF_DrawCommand cmd",
+        { "rect": SDL_Rect },
+      ]
+    )
+    const_set :TTF_CopyOperation, struct(
+      [
+        "TTF_DrawCommand cmd",
+        "int text_offset",
+        "TTF_Font *glyph_font",
+        "Uint32 glyph_index",
+        { "src": SDL_Rect },
+        { "dst": SDL_Rect },
+        "void *reserved",
+      ]
+    )
+    const_set :TTF_DrawOperation, union(
+      [
+        "TTF_DrawCommand cmd",
+        { "fill": TTF_FillOperation },
+        { "copy": TTF_CopyOperation },
+      ]
+    )
+    const_set :TTF_TextData, struct(
+      [
+        "TTF_Font *font",
+        { "color": SDL_FColor },
+        "bool needs_layout_update",
+        "TTF_TextLayout *layout",
+        "int x",
+        "int y",
+        "int w",
+        "int h",
+        "int num_ops",
+        "TTF_DrawOperation *ops",
+        "int num_clusters",
+        "TTF_SubString *clusters",
+        "SDL_PropertiesID props",
+        "bool needs_engine_update",
+        "TTF_TextEngine *engine",
+        "void *engine_text",
+      ]
+    )
+    const_set :TTF_TextEngine, struct(
+      [
+        "Uint32 version",
+        "void *userdata",
+        "function (*CreateText)()",
+        "function (*DestroyText)()",
+      ]
+    )
+  }
+  private_constant :SDL_ttf
+
+  SDL_ttf.call
+end

data/lib/rbsdl3/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SDL3
+  VERSION = "0.1.0"
+end

data/lib/rbsdl3.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+require "fiddle/import"
+require_relative "rbsdl3/version"
+
+module SDL3
+  module BindingsRefinement
+    refine Fiddle::Importer do
+      def extern(signature, *opts, unsupported: nil)
+        return unless (h = handler rescue nil) && !h.handlers.empty?
+        return if unsupported&.tap { |msg|
+          name = signature[/(\w+)\(/, 1]
+          define_method(name) { raise NotImplementedError, msg, caller(1) }
+          module_function(name)
+        }
+        begin
+          f = super
+        rescue Fiddle::DLError => e
+          # Re-trigger type-resolution DLErrors here, limiting the stubbing path
+          # to symbol-resolution failures.
+          name, = begin
+                    parse_signature(signature, type_alias)
+                  rescue Fiddle::DLError
+                    raise e
+                  end
+          module_eval(<<-EOS, __FILE__, __LINE__+1)
+            def #{name}(...)
+              e = ::NotImplementedError.new("SDL symbol not found: #{name}()")
+              e.set_backtrace(caller(1))
+              ::Kernel.raise(e)
+            end
+          EOS
+          module_function(name)
+        else
+          name = f.name
+          module_eval("private def #{name}(...) = ::SDL3.#{name}(...)")
+        end
+        f
+      end
+    end
+
+    refine Module do
+      def const_set(name, value)
+        const_defined?(name, false) ? value : super
+      end
+    end
+  end
+
+  extend Fiddle::Importer
+
+  DLLOAD_TARGETS = %i[SDL SDL_image SDL_ttf].freeze
+  private_constant :DLLOAD_TARGETS
+
+  def self.dlload(*libs)
+    super
+
+    # Map C 'enum' to an int-compatible type (mirrors common ABI layouts)
+    typealias "enum", "int"
+
+    DLLOAD_TARGETS.each do |m|
+      const_get(m, false).call if const_defined?(m, false)
+    end
+  end
+
+  dlload
+end
+require_relative "rbsdl3/sdl"

data/sig/sdl3.rbs

@@ -0,0 +1,4 @@
+module SDL3
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: rbsdl3
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- shinokaro
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fiddle
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.7
+description: 'rbsdl3 is a Ruby binding to SDL3 that links against an SDL dynamic library
+  chosen at runtime.
+
+  '
+email:
+- shinokaro@hotmail.co.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/rbsdl3.rb
+- lib/rbsdl3/image.rb
+- lib/rbsdl3/sdl.rb
+- lib/rbsdl3/ttf.rb
+- lib/rbsdl3/version.rb
+- sig/sdl3.rbs
+homepage: https://github.com/shinokaro/rbsdl3
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/shinokaro/rbsdl3
+  source_code_uri: https://github.com/shinokaro/rbsdl3
+  changelog_uri: https://github.com/shinokaro/rbsdl3/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: rbsdl3 is an SDL3 binding for Ruby implemented using Fiddle.
+test_files: []