dxruby64 1.4.7 → 1.4.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09456faf82b816e3acb5ab3134ac5062e9453e3f821c9f83835357ae334af644'
-  data.tar.gz: 18f08cc9f7139915b9f334e1ad12a44fef3f4db94b82c773dfe0d458cf123091
+  metadata.gz: 8969f30b264bb74aec40d2ca89abff5443350afa31d9eab253b625ff8f1620ce
+  data.tar.gz: 25adaca92fdd8dde71de97b7a33130acc8d31c5cdf36825ded1aaacf28f18ee5
 SHA512:
-  metadata.gz: 4c8a65bd3b7a8f3f7c6aca47b8098e897877614dee52ffeb76ec06e6c23522c7e8ad32fc950015097d61a1f5bedd02aec854f09e4ba975212ceea99143870712
-  data.tar.gz: af52610d33f31cdf2846dcffcff4e3b4e62e64fdefd66ff52a2c481cccddb14339ebdd34faeedd50f8d11d082bd42cf6764612f76699f52b1d34a6ceebb147b7
+  metadata.gz: d377d34e27c7a09ee0b1adce6d239ebfc9843d8b22a1a1eb3c4ad0c0f8484c660609a1dde18b8b9ca36ab593f6adf2a5f77814c8653dc339cb2d22573e4182d6
+  data.tar.gz: eb1bdf889a6e368a8e970bd4a0585b5ea91c846a9de49961622984741187648be7911b74084a1ef17bffc29dd7c669b00c8a7066579c6722f5bd3190460b1d5d

data/README-ja.md

@@ -55,6 +55,60 @@ gem contents dxruby64
 
 4. `Nov2008_d3dx9_40_x64.cab` の中にある `d3dx9_40.dll` を見つけ、Ruby のインストールフォルダ内の `bin` フォルダにコピー(または移動)します。（例：C:\Ruby34-x64\bin）
 
+## Soundクラスの改修について
+
+### 経緯など
+[本家DXRuby](https://github.com/mirichi/dxruby) の Soundクラスは `DirectMusic` というライブラリを使用していましたが、
+Windows 10/11 の 64bit 環境ではこの `DirectMusic` は正しく動作せず、以下のようなエラーが発生することが確認されています。
+
+```
+`DXRuby::Sound#initialize': DirectMusic initialize error - CoCreateInstance (DXRuby::DXRubyError)  
+```
+このため、DXRuby64では `DirectMusic` の代替として `DirectSound` というライブラリを使用するように改修をおこないました。
+(`DirectSound` は SoundEffectクラスでもすでに使用されており、実績のあるライブラリです)
+
+### 改修版 Soundクラスのサンプル
+
+前述のサンプルファイルの中に `wav_sample/`ディレクトリに改修版の Soundクラスを用いたサンプルを追加しましたのでお試しください。
+なお、下記の制限事項などについてもあわせてご確認ください。
+
+### 制限事項など
+
+`DirectSound` の機能上の制約などから、改修に伴って以下のような仕様変更をおこないました。
+
+- Soundクラスで扱うことができるファイル形式は `.wav` のみ ([本家DXRuby](https://github.com/mirichi/dxruby) では `.mid` も可)
+
+- 再生時のループ回数の指定はできず、「１回のみ再生」または「無限ループ」のいずれか
+
+- ゲームなどで利用される効果音や BGMなどの再生を念頭に、以下に記載の最小限のメソッドのみを実装
+
+```
+■使用できるメソッド(新規にアレンジしたものも含む)
+
+ .new             オブジェクトの生成
+ #play            再生
+ #stop            停止
+ #volume=         音量設定(0～255)
+ #set_volume      音量設定(上記 #volume= のエイリアス)  ※ただし従来の第2引数による音量フェード機能はなし
+ #loop=           ループ再生の採否設定(下記 #loop_count と同じ機能で、trueまたは falseで設定するもの)
+ #loop_count=     ループ回数設定(ただし、前述のように「１回のみ再生(0)」または「無限ループ(-1)」のみ可)
+ #dispose         オブジェクトの破棄
+ #disposed?       オブジェクト破棄状況のチェック
+```
+
+```
+■使用できないメソッド(本家DXRubyでは実装されていたもの)
+
+ .load_from_memory
+ #start=
+ #loop_start=
+ #loop_end=
+ #pan
+ #pan=
+ #frequency
+ #frequency=
+```
+
 ## ライセンス
 この gem は zlib/libpngライセンスの下で提供されています。
 

data/sample/wav_sample/desktop.ini

@@ -0,0 +1,4 @@
+[ViewState]
+Mode=
+Vid=
+FolderType=Generic

data/sample/wav_sample/dispose.rb

@@ -0,0 +1,17 @@
+require 'dxruby'
+
+sound = Sound.new("gameover.wav")   # gameover.wav読み込み
+
+puts sound.disposed?
+
+Window.loop do
+  if Input.key_push?(K_Z)           # [Z]キーで効果音を再生
+    sound.play
+    break
+  end
+end
+
+sleep 1
+sound.dispose
+puts sound.disposed?
+

data/sample/wav_sample/sound.rb

@@ -0,0 +1,34 @@
+require 'dxruby'
+
+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.loop = true                     # BGMは繰り返す(「.loop = true|false」形式での設定)
+bgm.play                            # BGB再生
+bgm.volume = 200                    # BGMの音量(「.volume = 値」形式での設定」)
+
+Window.loop do
+  Window.draw_font(20,  20, "[SPACE]  BGM停止", Font.default)
+  Window.draw_font(20,  80, "[↑]     BGM音量上げ", Font.default)
+  Window.draw_font(20, 110, "[↓]     BGM音量下げ", Font.default)
+  Window.draw_font(20, 140, "音量 : #{bgm.volume}", Font.default, color: [255, 255, 0])
+  Window.draw_font(20, 200, "[Z]      効果音 再生", Font.default)
+  Window.draw_font(20, 350, "[ESCAPE] 終了", Font.default)
+
+  if Input.key_push?(K_Z)           # [Z]キーで効果音を再生
+    sound.play
+  end
+  if Input.key_push?(K_SPACE)       # SPACEキーでBGM終了
+    bgm.stop
+  end
+  if Input.key_push?(K_UP)          # [↑]キーでBGMの音量を上げる
+    bgm.volume = bgm.volume + 5     #「.volume = 値」形式
+  end
+  if Input.key_push?(K_DOWN)        # [↓]キーでBGMの音量を下げる
+    bgm.volume = bgm.volume - 5     #「.volume = 値」形式
+  end
+
+  break if Input.key_push?(K_ESCAPE)
+end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dxruby64
 version: !ruby/object:Gem::Version
-  version: 1.4.7
+  version: 1.4.7.1
 platform: ruby
 authors:
 - Koki Kitamura
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-05-06 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,
@@ -117,10 +118,17 @@ 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/desktop.ini
+- sample/wav_sample/dispose.rb
+- sample/wav_sample/gameover.wav
+- sample/wav_sample/sound.rb
 homepage: https://github.com/spoolkitamura/dxruby64
 licenses:
 - Zlib
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/spoolkitamura/dxruby64
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -135,7 +143,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Custom build of DXRuby for 64-bit Ruby 3.1 and later (UCRT)
 test_files: []