dxruby64 1.4.7.1 → 1.4.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8969f30b264bb74aec40d2ca89abff5443350afa31d9eab253b625ff8f1620ce
-  data.tar.gz: 25adaca92fdd8dde71de97b7a33130acc8d31c5cdf36825ded1aaacf28f18ee5
+  metadata.gz: '08d94a581f72caf876b0bb2091e2476db409abc3d2533d35f068a6bfad2001aa'
+  data.tar.gz: fad534cf63dbd0b2745074ff7e60d9e2472956dbdb6469912ccb3d6920d3f7ab
 SHA512:
-  metadata.gz: d377d34e27c7a09ee0b1adce6d239ebfc9843d8b22a1a1eb3c4ad0c0f8484c660609a1dde18b8b9ca36ab593f6adf2a5f77814c8653dc339cb2d22573e4182d6
-  data.tar.gz: eb1bdf889a6e368a8e970bd4a0585b5ea91c846a9de49961622984741187648be7911b74084a1ef17bffc29dd7c669b00c8a7066579c6722f5bd3190460b1d5d
+  metadata.gz: d6abd1acc491d74b2c07cc1af34b2d56a9110da011f918971de1299383c4e43f3951b19dce44309d00f2fc00fd14e77a8d27528bccf98ae9bd0f30204c1daa47
+  data.tar.gz: 90a4c29b14d2ed2761f99c620e749cd765dee04ad6e028ad50056ac94ef8a0800d26508276feaa50183722f5f96ec11524ec6bf4a52b2f4e7efe02908b178660

data/README-ja.md

@@ -2,7 +2,8 @@
 
 **DXRuby64** は 64ビット版の Ruby 3.1以降用にカスタムビルドされた **DXRuby** で、Universal C Runtime(UCRT)でビルドできるように[本家DXRuby](https://github.com/mirichi/dxruby)のソースにパッチを当てたものです。DXRuby64により、64ビット版の Rubyでも DirectX9をベースにした 2Dゲームを開発できるようになります。
 
-**注意：** この gem は個人によって作成された非公式バージョンであり、オリジナルの DXRubyプロジェクトではメンテナンスされていません。
+**注意：**
+この gem は個人によって作成された非公式バージョンであり、本家DXRubyのプロジェクトでメンテナンスされているものではありません。
 
 [English README here](README.md)
 
@@ -14,6 +15,10 @@ gem をインストールするには、以下のコマンドを実行してく
 gem install dxruby64
 ```
 
+**注意：**
+DXRuby64の動作に影響が出る可能性がありますので、[本家DXRuby](https://github.com/mirichi/dxruby) がインストールされていない状態で上記のコマンドを実行してください。
+([本家DXRuby](https://github.com/mirichi/dxruby)は Ruby 3.1以降のバージョンには対応していないため、基本的に gemがインストールされていることはないと思われます)
+
 ## 使用方法
 インストール後、従来どおり DXRubyの機能を使うことができます。
 
@@ -41,13 +46,13 @@ gem contents dxruby64
 ```
 
 ## 必要条件
-- **Ruby 3.1 以降 (64ビット版)** が Windows にインストールされていること。
+- **Ruby 3.1 以降 (64ビット版)** が Windowsにインストールされていること。
 
-- `d3dx9_40.dll` が必要です。これは DirectX 9 ランタイムの一部です。もしインストールされていない場合は、[Microsoft の公式サイト](https://www.microsoft.com/en-us/download/details.aspx?id=8109)からダウンロードできます。
+- **`d3dx9_40.dll`** が配置されていること。これは DirectX 9 ランタイムの一部で、[Microsoft の公式サイト](https://www.microsoft.com/en-us/download/details.aspx?id=8109)からダウンロードすることができます。
 
-#### 【`d3dx9_40.dll` の入手方法】
+#### 【`d3dx9_40.dll` の入手および配置方法】
 
-1. [DirectX End-User Runtimes (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=8109) をダウンロードします。
+1. [DirectX End-User Runtimes (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=8109) に掲載されているファイル(`directx_Jun2010_redist.exe`)をダウンロードします。
 
 2. ダウンロードした `directx_Jun2010_redist.exe` をダブルクリックして、任意のディレクトリにファイルを展開します。
 
@@ -76,7 +81,8 @@ Windows 10/11 の 64bit 環境ではこの `DirectMusic` は正しく動作せ
 
 `DirectSound` の機能上の制約などから、改修に伴って以下のような仕様変更をおこないました。
 
-- Soundクラスで扱うことができるファイル形式は `.wav` のみ ([本家DXRuby](https://github.com/mirichi/dxruby) では `.mid` も可)
+- Soundクラスで扱うことができるファイル形式は `.wav` および `.mp3` 
+([本家DXRuby](https://github.com/mirichi/dxruby) では `.wav` および `.mid`)
 
 - 再生時のループ回数の指定はできず、「１回のみ再生」または「無限ループ」のいずれか
 
@@ -113,7 +119,7 @@ Windows 10/11 の 64bit 環境ではこの `DirectMusic` は正しく動作せ
 この gem は zlib/libpngライセンスの下で提供されています。
 
 ## 免責事項
-この gem は DXRubyの公式な後継ではなく、元の DXRubyプロジェクトによってメンテナンスされていません。これは、新しいバージョンの Ruby用に UCRT環境で動作することを目的としたカスタムビルドです。
+この gem は DXRubyの公式な後継ではなく、新しいバージョンの Ruby用に UCRT環境で動作することを目的としたカスタムビルドです。
 
 ## リポジトリ
 ソースコードや詳細情報は、以下のリポジトリで確認できます。

data/README.md

@@ -2,7 +2,8 @@
 
 **DXRuby64** is a custom-built version of DXRuby for 64-bit Ruby 3.1 and later, created by patching the original DXRuby source to allow building with the Universal C Runtime (UCRT). With DXRuby64, you can develop 2D games using DirectX 9 even on 64-bit Ruby environments.
 
-**Note:** This gem is an unofficial version created by an individual and is not maintained by the original DXRuby project.
+**Note:**
+This gem is an unofficial version created by an individual and is not maintained by the original DXRuby project.
 
 [日本語の README はこちら](README-ja.md)
 
@@ -14,6 +15,10 @@ To install the gem, simply run:
 gem install dxruby64
 ```
 
+**Note:**
+Please run the above command only when the original DXRuby is not installed, as it may interfere with the operation of DXRuby64.
+(The original DXRuby does not support Ruby versions 3.1 and later, so the gem is unlikely to be installed in most environments.)
+
 ## Usage
 Once installed, you can use DXRuby features as usual:
 
@@ -43,11 +48,11 @@ gem contents dxruby64
 ## Requirements
 - **Ruby 3.1 or later (64-bit)** installed on Windows.
 
-- `d3dx9_40.dll` is required. This is part of the DirectX 9 runtime. If it's not already installed, you can download it from [Microsoft's official site](https://www.microsoft.com/en-us/download/details.aspx?id=8109).
+- Ensure that **`d3dx9_40.dll`** is present. This DLL is part of the DirectX 9 runtime and can be downloaded from [the official Microsoft website](https://www.microsoft.com/en-us/download/details.aspx?id=8109).
 
-#### How to get `d3dx9_40.dll`
+#### How to obtain and place `d3dx9_40.dll`
 
-1. Download the [DirectX End-User Runtimes (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=8109).
+1. Download the file (`directx_Jun2010_redist.exe`) from [DirectX End-User Runtimes (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=8109).
 
 2. Double-click the downloaded `directx_Jun2010_redist.exe` and extract the files to a directory of your choice.
 
@@ -55,6 +60,63 @@ gem contents dxruby64
 
 4. Inside the `Nov2008_d3dx9_40_x64.cab` file, locate `d3dx9_40.dll` and copy (or move) it to the `bin` directory of your Ruby installation folder. (e.g. C:\Ruby34-x64\bin)
 
+
+
+
+
+## About the Sound Class Revision
+### Background
+The [original DXRuby](https://github.com/mirichi/dxruby) Sound class used a library called `DirectMusic`.
+However, on 64-bit environments of Windows 10/11, `DirectMusic` does not function correctly, and the following error has been confirmed:
+
+```
+`DXRuby::Sound#initialize': DirectMusic initialize error - CoCreateInstance (DXRuby::DXRubyError)  
+```
+
+Therefore, in DXRuby64, we replaced `DirectMusic` with a library called `DirectSound`.
+(`DirectSound` is already used in the SoundEffect class and is a proven library.)
+
+### Sample of the Revised Sound Class
+A sample using the revised Sound class has been added to the `wav_sample/` directory within the sample files mentioned earlier.
+Please give it a try.
+Also, be sure to review the following limitations and changes.
+
+### Limitations and Specification Changes
+Due to functional constraints of `DirectSound`, the following changes were made as part of the revision:
+
+- The Sound class supports `.wav` and `.mp3` file formats
+(The [original DXRuby](https://github.com/mirichi/dxruby) supports `.wav` and `.mid`)
+
+- Loop count cannot be specified; only "play once" or "infinite loop" are supported
+
+- Designed with use cases like sound effects and BGM for games in mind, only a minimal set of methods (listed below) is implemented
+
+```
+Available Methods (including newly arranged ones)
+
+ .new             Create an object
+ #play            Play
+ #stop            Stop
+ #volume=         Set volume (0 to 255)
+ #set_volume      Set volume (alias of #volume=, but the old fade effect via a second argument is not supported)
+ #loop=           Set loop mode (same as #loop_count; accepts true or false)
+ #loop_count=     Set loop count (only two options supported: 0 = play once, -1 = loop infinitely)
+ #dispose         Dispose the object
+ #disposed?       Check if the object has been disposed
+```
+```
+Unsupported Methods (implemented in the original DXRuby)
+
+ .load_from_memory
+ #start=
+ #loop_start=
+ #loop_end=
+ #pan
+ #pan=
+ #frequency
+ #frequency=
+```
+
 ## License
 This gem is licensed under the zlib/libpng license.
 

data/sample/wav_sample/sound.rb

@@ -4,7 +4,7 @@ sound = Sound.new("gameover.wav")   # gameover.wav読み込み
 sound.loop_count = 0                # 効果音は繰り返さない(「.loop_count = -1|0」形式での設定)
 sound.set_volume(255)               # 効果音の音量(最大)(「.set_volume(値)」形式での設定)
 
-bgm = Sound.new("backg.wav")        # backg.wav読み込み
+bgm = Sound.new("backg.mp3")        # backg.mp3読み込み
 bgm.loop = true                     # BGMは繰り返す(「.loop = true|false」形式での設定)
 bgm.play                            # BGB再生
 bgm.volume = 200                    # BGMの音量(「.volume = 値」形式での設定」)

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: dxruby64
 version: !ruby/object:Gem::Version
-  version: 1.4.7.1
+  version: 1.4.7.2
 platform: ruby
 authors:
 - Koki Kitamura
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-06 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: This gem provides a custom build of DXRuby for Ruby 3.1 and later, compiled
   for 64-bit Ruby versions using UCRT (Universal C Runtime) on Windows. It is a personal,
@@ -118,7 +117,7 @@ files:
 - sample/shader_sample/sample_vertexshader.rb
 - sample/shader_sample/sample_wingman.rb
 - sample/shader_sample/turn_transition.rb
-- sample/wav_sample/backg.wav
+- sample/wav_sample/backg.mp3
 - sample/wav_sample/desktop.ini
 - sample/wav_sample/dispose.rb
 - sample/wav_sample/gameover.wav
@@ -128,7 +127,6 @@ licenses:
 - Zlib
 metadata:
   homepage_uri: https://github.com/spoolkitamura/dxruby64
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -143,8 +141,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Custom build of DXRuby for 64-bit Ruby 3.1 and later (UCRT)
 test_files: []