-
Notifications
You must be signed in to change notification settings - Fork 0
/
Ligni Core.rb
5655 lines (5635 loc) · 244 KB
/
Ligni Core.rb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
#==============================================================================
# ҉ Ligni Core
#==============================================================================
# Authors: (Dax Soft & Alisson) -> ligni
# Version: 1.0
# Credits:
# - Gab! (register mode)
# - Gotoken : benchmark module
# Support:
# - Dax Soft : https://www.dax-soft.weebly.com
# - Alisson : https://prismengine.wordpress.com/
# - Help File : <download link>
#==============================================================================
# A core with several modules and methods that will make easiest on the time
# of programmer your scripts, good look.
#==============================================================================
# Contents : • TAGS : Use CTRL+F to locate the code.
# - Marshal :marshal
# - File :file
# - Array :array
# - Hash :hash
# - String :string
# - Integer :integer
# - Numeric :numeric
# - API :api
# - API::MessageBox :messagebox
# - API::PNG :png
# - API::Find :find
# - API::FindPlus :findplus
# - API::Network :network
# - API::Powershell :powershell
# - Ligni::Key :key
# - Ligni::Behaviour :behaviour
# - Ligni::Invoke :invoke
# - Ligni::InvokeRepeating :invoke_repeating
# - Ligni::Mathf :mathf
# - Ligni::Vector :vector
# - Ligni::Color :ligni_color
# - Ligni::Position :position
# - Ligni::Axis :axis
# - Ligni::Collision :collision
# - Ligni::Advanced_Sprite
# - Ligni::Advanced_Sprite_Component
# - Rect :rect
# - Sprite :sprite
# - Bitmap :bitmap
# - Window_Base :window_base
# - Ligni::Backup :backup
# - Opacity :opacity
# - Ligni::Mouse :mouse
# - Benchmark :benchmark
# - Object :object
# - Kernel :kernel
# - SceneManager :scenemanager
# - Graphics :graphic
#==============================================================================
module Ligni; extend self
#----------------------------------------------------------------------------
# • Constants
#----------------------------------------------------------------------------
STANDALONE = Module.new # Módulo para a criação de scripts standalone.
NOTE_SEPARATOR = "<>" # Separador de notas do Database.
FIXED_UPDATE_COUNT = 15 # Tempo de espera para o fixed update.
SECOND_UPDATE_COUNT = 60 # Tempo de espera para o update de segundos.
VERSION = '1.0' # Versão do Core
# If you don't wanna that mouse system was a picture, don't set anything
# on the constant bellow... If you wanna, set the name of the picture...
# the picture has to be on the directory System.
MOUSE_NAME = ""
#----------------------------------------------------------------------------
# • Variables
#----------------------------------------------------------------------------
@fx_up_count = 15 # Contagem inicial do fixed update.
@sc_up_count = 60 # Contagem inicial do second update.
@@data = {} # registro dos scripts
@@_data = {} # garbage dos registros
@@setup = {} # registrar configurações de scripts, moldável
#----------------------------------------------------------------------------
# • [Boolean] : Register the script
# [symbol] : name : name of your script
# [string] : author : author of the script
# [numeric] : version : version
# [array] : requires : requires to exec your script
# [proc] : &block : block that will content all script
# requires : Set inside on array, another array, that contents
# the name of the script, author e if you wanna, the version.
#----------------------------------------------------------------------------
def register(name, author, version, requires=[], &block)
need = []
requires.each { |data| need << data unless self.registered?(*data) }
if need.empty?
@@data[[name, author]] = version
@@setup[[name, author]] = {}
block.call
@@_data.each_pair { |(cache_name, cache_author, cache_version), (_need, _block)|
_need.delete_if { |_n_| self.registered?(*_n_) }
next unless _need.empty?
@@_data.delete([cache_name, cache_author, cache_version])
self.register(cache_name, cache_author, cache_version, &_block)
}
else
@@_data[[name, author, version]] = [need, block]
end
return true
end
#----------------------------------------------------------------------------
# • [Boolean] : Check out if has been registered
# [symbol] : name : script's name
# [string] : author : author's name
# [numeric] : version : version's name
#----------------------------------------------------------------------------
def registered?(name, author, version=nil)
if @@data.has_key?([name, author])
return true if version.nil?
_version = @@data[[name, author]]
return _version >= version
else
return false
end
end
#----------------------------------------------------------------------------
# • [Boolean] Set a script as requirement, if don't have this script, you will be
# take a warnin' about it
# [symbol] : name : script's name
# [string] : author : author's name
# [numeric] : version : version's script
#----------------------------------------------------------------------------
def required(name, author, version=nil)
if @@data.has_key?([name, author])
return true if version.nil?
_version = @@data[[name, author]]
if _version >= version
return true
else
msgbox("Script off update: #{String(name)} v#{String(_version)} por #{String(author)}\nVersion of requirement: #{version}")
exit
end
else
msgbox("Script don't found: #{String(name)} v#{String(version)} por #{String(author)}")
exit
end
return true
end
#----------------------------------------------------------------------------
# • [Hash] Return to @@data
#----------------------------------------------------------------------------
def data
@@data
end
#----------------------------------------------------------------------------
# • [Hash] Return to @@setup | return to setup[[name, author]] = {}
#----------------------------------------------------------------------------
def setup
@@setup
end
#----------------------------------------------------------------------------
# • [Object] setup param
# rkey = [script, author]
# key
#----------------------------------------------------------------------------
def param(rkey, key, value=nil, &block)
setup[rkey][key] = {} if setup[rkey][key].nil?
if block_given?
setup[rkey][key][:param] = block.call
else
setup[rkey][key][:param] = value
end
end
#----------------------------------------------------------------------------
# • [Object] setup help
# rkey = [script, author]
# key
#----------------------------------------------------------------------------
def help(rkey, key, value=nil, &block)
setup[rkey][key] = {} if setup[rkey][key].nil?
if block_given?
setup[rkey][key][:help] = block.call
else
setup[rkey][key][:help] = value
end
end
#----------------------------------------------------------------------------
# • getParam
# rkey = [script, author]
# key
#----------------------------------------------------------------------------
def getParam(rkey, key)
setup[rkey][key] = {} if setup[rkey][key].nil?
setup[rkey][key][:param] = "" unless setup[rkey][key].has_key?(:param)
setup[rkey][key][:param]
end
#----------------------------------------------------------------------------
# • getHelp
# rkey = [script, author]
# key
#----------------------------------------------------------------------------
def getHelp(rkey, key)
setup[rkey][key] = {} if setup[rkey][key].nil?
setup[rkey][key][:help] = "" unless setup[rkey][key].has_key?(:help)
setup[rkey][key][:help]
end
#----------------------------------------------------------------------------
# • [Boolean] Remove a scene (your "use" on $RGSS)
#----------------------------------------------------------------------------
def remove(symbol_name)
Object.send(:remove_const, symbol_name)
end
#----------------------------------------------------------------------------
# • [Output] Print a list that contain all registred script on Core.
#----------------------------------------------------------------------------
def list_string
puts "List of registered scripts on Core: ~ Total: %d" % self.data.size
self.data.each_pair { |key, value|
puts sprintf("\t- script: (%s) from %s [%s]", key[0].to_s, key[1].to_s, value.to_s)
}
puts "..."
end
#----------------------------------------------------------------------------
# • export(data, ext)
#----------------------------------------------------------------------------
def export(data, ext)
save_data(Zlib::Deflate.deflate(data, Zlib::BEST_COMPRESSION), ext)
end
#----------------------------------------------------------------------------
# • import(data, ext)
#----------------------------------------------------------------------------
def import(data)
return Zlib::Inflate.inflate(load_data(data)).force_encoding("UTF-8")
end
#----------------------------------------------------------------------------
# • update
#----------------------------------------------------------------------------
def update
fixed_update
second_update
Ligni::Key.update
Ligni::Behaviour.main_update
Ligni::Mouse.update
end
#----------------------------------------------------------------------------
# • fixed_update
#----------------------------------------------------------------------------
def fixed_update
next_count = @fx_up_count + 1
next_count > FIXED_UPDATE_COUNT ? @fx_up_count = 0 : @fx_up_count += 1
end
#----------------------------------------------------------------------------
# • second_update
#----------------------------------------------------------------------------
def second_update
next_count = @sc_up_count + 1
next_count > SECOND_UPDATE_COUNT ? @sc_up_count = 0 : @sc_up_count += 1
end
#----------------------------------------------------------------------------
# • folder_name_check
#----------------------------------------------------------------------------
def folder_name_check(string)
result = string
result.gsub!(/\\\//) {"_"}
result.gsub!(/:/) {"-"}
result.gsub!(/\*\?<>\|/) {""}
return result
end
#----------------------------------------------------------------------------
# • run_fixed_update?
#----------------------------------------------------------------------------
def run_fixed_update?
@fx_up_count == 15
end
#----------------------------------------------------------------------------
# • run_second_update?
#----------------------------------------------------------------------------
def run_second_update?
@sc_up_count == 60
end
#----------------------------------------------------------------------------
# • load_tags
#----------------------------------------------------------------------------
def load_tags
[$data_actors, $data_classes, $data_skills, $data_items,
$data_weapons, $data_armors, $data_enemies, $data_states].each do |object|
object.each do |item|
next unless item
item.start_note_container
end
end
end
#----------------------------------------------------------------------------
# • extract_scripts
#----------------------------------------------------------------------------
def extract_scripts(folder)
Dir.mkdir(folder) unless Dir.exists?(folder)
c = 0
$RGSS_SCRIPTS.each {|sc|
n = folder_name_check(folder + sprintf("%d - #{sc[1]}.rb", c))
t = sc[3]
next if t.empty?
begin
f = File.open(n, "w")
f.write(t)
ensure
f.close
end
c += 1
}
end
#----------------------------------------------------------------------------
# •
#----------------------------------------------------------------------------
end
#==============================================================================
# ҉ Marshal
#==============================================================================
Ligni.register(:marshal, "ligni", 1.0) {
class << Marshal
#┌───────────────┬──────┬────────────────────────────────────────────────────┐
#│ ♦ prism_load │ load │ Permite a leitura de arquivos que não sejam do RM. │
#└───────────────┴──────┴────────────────────────────────────────────────────┘
alias :ligni_load :load
def load(port, proc = nil)
ligni_load(port, proc)
rescue TypeError
if port.kind_of?(File)
port.rewind
port.read
else
port
end
end
end unless Marshal.respond_to?(:ligni_load) # ▫ ▫ ▫ ▫ ▫ ▫ ▫ ▫ ▫ ▫ ▫ ▫ Marshal ◄
}
#==============================================================================
# • File
#==============================================================================
Ligni.register(:file, "ligni", 1.0) {
class << File
#----------------------------------------------------------------------------
# • [BooleanClass] : Execute a file script
#----------------------------------------------------------------------------
def eval(filename)
return unless filename.match(/.rb|.rvdata2/) or FileTest.exist?(filename)
script = ""
nilcommand = false
IO.readlines(filename).each { |i|
if i.match(/^=begin/)
nilcommand = true
elsif i.match(/^=end/) and nilcommand
nilcommand = false
elsif !nilcommand
script += i.gsub(/#(.*)/, "").to_s + "\n"
end
}
Kernel.eval(script)
return true
end
#----------------------------------------------------------------------------
# • [String] : Get the most recent file on dir
#----------------------------------------------------------------------------
def recent(dir="*")
return Dir.glob(dir).sort {|a,b| File.ctime(a) <=> File.ctime(b)}.last
end
end
}
#==============================================================================
# • Array
#==============================================================================
Ligni.register(:array, "ligni", 1.0) {
class Array
#----------------------------------------------------------------------------
# • instance variables of the class
#----------------------------------------------------------------------------
attr_reader :next
attr_reader :pred
#----------------------------------------------------------------------------
# • [Hash] : Turn on the array to hash
# Set ou a value for all keys
# [1, 2].to_hash_keys { :default_value }
# { 1 => :default_value, 2 => :default_value }
#----------------------------------------------------------------------------
def to_hash_keys(&block)
Hash[*self.collect { |v|
[v, block.call(v)]
}.flatten]
end
#----------------------------------------------------------------------------
# • [Array] : Sortin' all objects on crescent ordem
#----------------------------------------------------------------------------
def crescent
sort! { |a, b| a <=> b }
end
#----------------------------------------------------------------------------
# • [Array] : Sortin' all objects on decrescent ordem
#----------------------------------------------------------------------------
def decrescent
sort! { |a, b| b <=> a }
end
#----------------------------------------------------------------------------
# • [Object] : Return to the next value available
# x = [1, 8]
# x.next # 1
# x.next # 8
#----------------------------------------------------------------------------
def next(x=0)
@next = (@next.nil? ? 0 : @next == self.size - 1 ? 0 : @next.next + x)
return self[@next]
end
alias :+@ :next
#----------------------------------------------------------------------------
# • [Object] : Return to the previous value available
# x = [1, 8]
# x.prev # 8
# x.prev # 1
#----------------------------------------------------------------------------
def pred(x = 0)
@prev = (@prev.nil? ? self.size-1 : @prev == 0 ? self.size-1 : @prev.pred + x)
return self[@prev]
end
alias :-@ :pred
#----------------------------------------------------------------------------
# • [Mixed] : Return to the first value available follow by the rule fixed
# msgbox [2, 3, 4, 5, 6].first! { |n| n.is_evan? } #> 2
# msgbox [2, 3, 4, 5, 6].first! { |n| n.is_odd? } #> 3
#----------------------------------------------------------------------------
def first!
return unless block_given?
return self.each { |element| return element if yield(element) }.at(0)
end
#----------------------------------------------------------------------------
# • [Numeric] : Return a numeric value, all avaiable, that can be:
# v : :+ # add
# :- # decrease
# :* # multiple
# nil # avarage
#----------------------------------------------------------------------------
def alln?(v=nil)
n = v == :* ? 1 : 0
self.if {|i| i.is_a?(Numeric) }.each { |content|
if v == :+
n += content; next
elsif v == :-
n -= content; next
elsif v == :*
n *= content; next
else
n += content; next
end
}
return (v == nil ? (n/self.size) : n)
end
#┌──────────────┬────────────────────────────────────────────────────────────┐
#│ ♦ array_nil? │ Checa se todos os elementos de um array é nil. │
#├──────────────┴────────────────────────────────────────────────────────────┤
#│ → array: a array em questão. │
#└───────────────────────────────────────────────────────────────────────────┘
def array_nil?(array)
return array.compact.size.zero?
end
#┌───────────────────────────────────────────────────────────────────────────┐
#│ ♦ array_compact_sample │
#├───────────────────────────────────────────────────────────────────────────┤
#│ Obtém um item aleatório de uma array, exceto os itens nil. │
#│ Caso ela possua apenas nil, retorna false. │
#│ → array: A array em questão. │
#└───────────────────────────────────────────────────────────────────────────┘
def array_compact_sample(array)
return false if array_nil?(array)
result = array.compact.sample
end
#┌───────────────────────────────────────────────────────────────────────────┐
#│ ♦ num_to_string │
#├───────────────────────────────────────────────────────────────────────────┤
#│ Converte uma array de códigos de caracteres em UTF-8 em uma string. │
#│ O formato precisa ser o mesmo gerado pelo Prism.string_to_num. │
#│ Ex: "Heya" seria [72, 101, 121, 97]. │
#│ → array: uma array no formato mostrado acima. │
#└───────────────────────────────────────────────────────────────────────────┘
def num_to_string(array)
result = ""
array.each do |n|
result << [n].pack("C")[0]
end
return result
end
end
}
#==============================================================================
# • Hash
#==============================================================================
Ligni.register(:hash, "ligni", 1.0) {
class Hash
#----------------------------------------------------------------------------
# • [NilClass or Mixed] : Get the value of the specific key
# key : Chave.
# block(proc) : Condition to return the value of the key
# {1 => 12}.get(1) #=> 12
# {1 => 12}.get(1) { |k| k.is_a?(String) } #=> nil
#----------------------------------------------------------------------------
def get(key)
if block_given?
self.keys.each { |data|
next unless key == data
return self[data] if yield(self[data])
}
else
self.keys.each { |data| return self[data] if key == data }
end
return nil
end
#----------------------------------------------------------------------------
# • [Mix] : Return to the last key of the variable
#----------------------------------------------------------------------------
def last_key
return self.keys.last
end
end
}
#==============================================================================
# * String
#==============================================================================
Ligni.register(:string, "ligni", 1.0) {
class String
#----------------------------------------------------------------------------
# • [String] : Remove and added a extension on the string
# filename : filename
# extension : new extension
# "Hello.rb".extn(".rvdata2") # "Hello.rvdata2"
#----------------------------------------------------------------------------
def extn(extension)
ext = extension.include?(".") ? extension : "." + extension
if self.include?(".")
self.gsub(/\.(\w+)/, ext)
else
return self + ext
end
end
#--------------------------------------------------------------------------
# • [String] : convert the string to UTF-8
#--------------------------------------------------------------------------
def to_utf8
API.textUTF(self)
end
#┌───────────────────────────────────────────────────────────────────────────┐
#│ ♦ string_to_num │
#├───────────────────────────────────────────────────────────────────────────┤
#│ Usado para transformar uma string em uma array de códigos dos caracteres │
#│ em UTF-8 (basicamente, transformar letras em números) │
#│ → string: uma string qualquer. │
#└───────────────────────────────────────────────────────────────────────────┘
def string_to_num
result = []
for i in 0...self.size
result.push(string[i].unpack("U")[0])
end
return result
end
#┌────────────────┬──────────────────────────────────────────────────────────┐
#│ ♦ only_spaces? │ Checa se uma string possui apenas espaços. │
#├────────────────┴──────────────────────────────────────────────────────────┤
#│ → string: a string em questão. │
#└───────────────────────────────────────────────────────────────────────────┘
def only_spaces?
return self =~ /^\s*$/
end
#----------------------------------------------------------------------------
# • [String] : convert to w_char
#----------------------------------------------------------------------------
def w_char
wstr = ""
self.size.times { |i| wstr += self[i, 1] + "\0" }
wstr += "\0"
return wstr
end
#--------------------------------------------------------------------------
# • [Array] : Extract just the numeric values (integers) and return to a array
# Exemplo: "João89".number # [8, 9]
#--------------------------------------------------------------------------
def number
self.scan(/-*\d+/).collect{|n|n.to_i}
end
alias :num :number
#----------------------------------------------------------------------------
# • [String] : Aplly case sensitive, underline
# "Exemplo 2" => "Exemplo_2"
#----------------------------------------------------------------------------
def case_sensitive
return self.gsub(" ", "_")
end
#----------------------------------------------------------------------------
# • [Symbol] : turn on a string to symbol
# "Ola Meu Nome É" #:ola_menu_nome_é
#----------------------------------------------------------------------------
def symbol
return self.case_sensitive.downcase.to_sym
end
#----------------------------------------------------------------------------
# • [String] : remove the last character /alternativa to chomp/
#----------------------------------------------------------------------------
def backslash
return String(self[0, self.split(//).size-1])
end
#----------------------------------------------------------------------------
# • [String] : Limited of the string
#----------------------------------------------------------------------------
def trunca(start=0, length=20, ellipsis='')
if self.length > length
self[start..length].gsub(/\s*\S*\z/, '').rstrip+ellipsis
else
self.rstrip
end
end
#----------------------------------------------------------------------------
# • Xor's method
#----------------------------------------------------------------------------
def ^(string)
bytes.map.with_index{|byte, index| byte ^ other[index % other.size].ord }.pack("C*")
end
alias xor ^
end
}
#==============================================================================
# * Integer
#==============================================================================
Ligni.register(:integer, "ligni", 1.0) {
class Integer
#----------------------------------------------------------------------------
# • [TrueClass/FalseClass] : Check out if it is evan
#----------------------------------------------------------------------------
def is_evan?
return (self & 1) == 0
end
#----------------------------------------------------------------------------
# • [TrueClass/FalseClass] : Check out if it is odd
#----------------------------------------------------------------------------
def is_odd?
return (self & 1) == 1
end
#----------------------------------------------------------------------------
# • [Integer] : Crescent the value until came to maximum (setting), when it's comming
# at the maximun, return to zero (can be set)
# back : return value
# max : maximum value
# compare : condition method | :> :< :>= :<=
#----------------------------------------------------------------------------
def up(back, max, compare=:>)
return (self.method(compare).call(max) ? back : (self + 1))
end
#----------------------------------------------------------------------------
# • [Integer] : Decrease the value until came to zero(setting), when it's comming
# at the zero, return to maximum (can be set)
# back : return value
# max : maximum value
# compare : condition method | :> :< :>= :<=
#----------------------------------------------------------------------------
def down(back, r=0, compare=:<)
return (self.method(compare).call(back) ? r : (self - 1))
end
#----------------------------------------------------------------------------
# • [Integer] : Get out a random number
#----------------------------------------------------------------------------
def aleatory
return ((1..(self.abs)).to_a).shuffle[rand(self).to_i].to_i
end
end
}
#==============================================================================
# • Numeric
#==============================================================================
Ligni.register(:numeric, "ligni", 1.0) {
class Numeric
#----------------------------------------------------------------------------
# * [Numeric] : Bring to percent value
# a : actual value
# b : maximum value
#----------------------------------------------------------------------------
def to_p(a, b)
self * a / b
end
alias :percent :to_p
#----------------------------------------------------------------------------
# • [Numeric] : Get out a percent
# max : maximum value
#----------------------------------------------------------------------------
def p_to(max)
(self * max) / 100
end
alias :proportion :p_to
#----------------------------------------------------------------------------
# * [Numeric] : randomic numeric
# x : total variation. [-x, x]
#----------------------------------------------------------------------------
def randomic(x=4)
return ( (self+rand(2)) + (self + (rand(2) == 0 ? rand(x) : -rand(x)) ) ) / 2
end
#----------------------------------------------------------------------------
# * [Boolean] : Check out if the numeber is equal to a specified number setup
# 1.equal?(2, 3) # false
#----------------------------------------------------------------------------
def equal?(*args)
args.each { |i|
self == i ? (return true) : next
}
return false
end
end
}
#==============================================================================
# • API :
#==============================================================================
Ligni.register(:api, "ligni", 1.0) {
module API
extend self
#----------------------------------------------------------------------------
# • [String] : unknow artisit : type of pointers
#----------------------------------------------------------------------------
TYPES = {
struct: "p",
int: "i",
long: "l",
INTERNET_PORT: "l",
SOCKET: "p",
C: "p", #– 8-bit unsigned character (byte)
c: "p", # 8-bit character (byte)
# "i"8 – 8-bit signed integer
# "i"8 – 8-bit unsigned integer
S: "N", # – 16-bit unsigned integer (Win32/API: S used for string params)
s: "n", # – 16-bit signed integer
# "i"16 – 16-bit unsigned integer
# "i"16 – 16-bit signed integer
I: "I", # 32-bit unsigned integer
i: "i", # 32-bit signed integer
# "i"32 – 32-bit unsigned integer
# "i"32 – 32-bit signed integer
L: "L", # unsigned long int – platform-specific size
l: "l", # long int – platform-specific size. For discussion of platforms, see:
# (http://groups.google.com/group/ruby-ffi/browse_thread/thread/4762fc77130339b1)
# "i"64 – 64-bit signed integer
# "i"64 – 64-bit unsigned integer
# "l"_long – 64-bit signed integer
# "l"_long – 64-bit unsigned integer
F: "L", # 32-bit floating point
D: "L", # 64-bit floating point (double-precision)
P: "P", # pointer – platform-specific size
p: "p", # C-style (NULL-terminated) character string (Win32API: S)
B: "i", # (?? 1 byte in C++)
V: "V", # For functions that return nothing (return type void).
v: "v", # For functions that return nothing (return type void).
LPPOINT: "p",
# Windows-specific type defs (ms-help://MS.MSDNQTR.v90.en/winprog/winprog/windows_data_types.htm):
ATOM: "I", # Atom ~= Symbol: Atom table stores strings and corresponding identifiers. Application
# places a string in an atom table and receives a 16-bit integer, called an atom, that
# can be used to access the string. Placed string is called an atom name.
# See: http://msdn.microsoft.com/en-us/library/ms648708%28VS.85%29.aspx
BOOL: "i",
BOOLEAN: "i",
BYTE: "p", # Byte (8 bits). Declared as unsigned char
#CALLBACK: K, # Win32.API gem-specific ?? MSDN: #define CALLBACK __stdcall
CHAR: "p", # 8-bit Windows (ANSI) character. See http://msdn.microsoft.com/en-us/library/dd183415%28VS.85%29.aspx
COLORREF: "i", # Red, green, blue (RGB) color value (32 bits). See COLORREF for more info.
DWORD: "i", # 32-bit unsigned integer. The range is 0 through 4,294,967,295 decimal.
DWORDLONG: "i", # 64-bit unsigned integer. The range is 0 through 18,446,744,073,709,551,615 decimal.
DWORD_PTR: "l", # Unsigned long type for pointer precision. Use when casting a pointer to a long type
# to perform pointer arithmetic. (Also commonly used for general 32-bit parameters that have
# been extended to 64 bits in 64-bit Windows.) BaseTsd.h: #typedef ULONG_PTR DWORD_PTR;
DWORD32: "I",
DWORD64: "I",
HALF_PTR: "i", # Half the size of a pointer. Use within a structure that contains a pointer and two small fields.
# BaseTsd.h: #ifdef (_WIN64) typedef int HALF_PTR; #else typedef short HALF_PTR;
HACCEL: "i", # (L) Handle to an accelerator table. WinDef.h: #typedef HANDLE HACCEL;
# See http://msdn.microsoft.com/en-us/library/ms645526%28VS.85%29.aspx
HANDLE: "l", # (L) Handle to an object. WinNT.h: #typedef PVOID HANDLE;
# todo: Platform-dependent! Need to change to "i"64 for Win64
HBITMAP: "l", # (L) Handle to a bitmap: http://msdn.microsoft.com/en-us/library/dd183377%28VS.85%29.aspx
HBRUSH: "l", # (L) Handle to a brush. http://msdn.microsoft.com/en-us/library/dd183394%28VS.85%29.aspx
HCOLORSPACE: "l", # (L) Handle to a color space. http://msdn.microsoft.com/en-us/library/ms536546%28VS.85%29.aspx
HCURSOR: "l", # (L) Handle to a cursor. http://msdn.microsoft.com/en-us/library/ms646970%28VS.85%29.aspx
HCONV: "l", # (L) Handle to a dynamic data exchange (DDE) conversation.
HCONVLIST: "l", # (L) Handle to a DDE conversation list. HANDLE - L ?
HDDEDATA: "l", # (L) Handle to DDE data (structure?)
HDC: "l", # (L) Handle to a device context (DC). http://msdn.microsoft.com/en-us/library/dd183560%28VS.85%29.aspx
HDESK: "l", # (L) Handle to a desktop. http://msdn.microsoft.com/en-us/library/ms682573%28VS.85%29.aspx
HDROP: "l", # (L) Handle to an internal drop structure.
HDWP: "l", # (L) Handle to a deferred window position structure.
HENHMETAFILE: "l", #(L) Handle to an enhanced metafile. http://msdn.microsoft.com/en-us/library/dd145051%28VS.85%29.aspx
HFILE: "i", # (I) Special file handle to a file opened by OpenFile, not CreateFile.
# WinDef.h: #typedef int HFILE;
REGSAM: "i",
HFONT: "l", # (L) Handle to a font. http://msdn.microsoft.com/en-us/library/dd162470%28VS.85%29.aspx
HGDIOBJ: "l", # (L) Handle to a GDI object.
HGLOBAL: "l", # (L) Handle to a global memory block.
HHOOK: "l", # (L) Handle to a hook. http://msdn.microsoft.com/en-us/library/ms632589%28VS.85%29.aspx
HICON: "l", # (L) Handle to an icon. http://msdn.microsoft.com/en-us/library/ms646973%28VS.85%29.aspx
HINSTANCE: "l", # (L) Handle to an instance. This is the base address of the module in memory.
# HMODULE and HINSTANCE are the same today, but were different in 16-bit Windows.
HKEY: "l", # (L) Handle to a registry key.
HKL: "l", # (L) Input locale identifier.
HLOCAL: "l", # (L) Handle to a local memory block.
HMENU: "l", # (L) Handle to a menu. http://msdn.microsoft.com/en-us/library/ms646977%28VS.85%29.aspx
HMETAFILE: "l", # (L) Handle to a metafile. http://msdn.microsoft.com/en-us/library/dd145051%28VS.85%29.aspx
HMODULE: "l", # (L) Handle to an instance. Same as HINSTANCE today, but was different in 16-bit Windows.
HMONITOR: "l", # (L) ?andle to a display monitor. WinDef.h: if(WINVER >= 0x0500) typedef HANDLE HMONITOR;
HPALETTE: "l", # (L) Handle to a palette.
HPEN: "l", # (L) Handle to a pen. http://msdn.microsoft.com/en-us/library/dd162786%28VS.85%29.aspx
HRESULT: "l", # Return code used by COM interfaces. For more info, Structure of the COM Error Codes.
# To test an HRESULT value, use the FAILED and SUCCEEDED macros.
HRGN: "l", # (L) Handle to a region. http://msdn.microsoft.com/en-us/library/dd162913%28VS.85%29.aspx
HRSRC: "l", # (L) Handle to a resource.
HSZ: "l", # (L) Handle to a DDE string.
HWINSTA: "l", # (L) Handle to a window station. http://msdn.microsoft.com/en-us/library/ms687096%28VS.85%29.aspx
HWND: "l", # (L) Handle to a window. http://msdn.microsoft.com/en-us/library/ms632595%28VS.85%29.aspx
INT: "i", # 32-bit signed integer. The range is -2147483648 through 2147483647 decimal.
INT_PTR: "i", # Signed integer type for pointer precision. Use when casting a pointer to an integer
# to perform pointer arithmetic. BaseTsd.h:
#if defined(_WIN64) typedef __int64 INT_PTR; #else typedef int INT_PTR;
INT32: "i", # 32-bit signed integer. The range is -2,147,483,648 through +...647 decimal.
INT64: "i", # 64-bit signed integer. The range is –9,223,372,036,854,775,808 through +...807
LANGID: "n", # Language identifier. For more information, see Locales. WinNT.h: #typedef WORD LANGID;
# See http://msdn.microsoft.com/en-us/library/dd318716%28VS.85%29.aspx
LCID: "i", # Locale identifier. For more information, see Locales.
LCTYPE: "i", # Locale information type. For a list, see Locale Information Constants.
LGRPID: "i", # Language group identifier. For a list, see EnumLanguageGroupLocales.
LONG: "l", # 32-bit signed integer. The range is -2,147,483,648 through +...647 decimal.
LONG32: "i", # 32-bit signed integer. The range is -2,147,483,648 through +...647 decimal.
LONG64: "i", # 64-bit signed integer. The range is –9,223,372,036,854,775,808 through +...807
LONGLONG: "i", # 64-bit signed integer. The range is –9,223,372,036,854,775,808 through +...807
LONG_PTR: "l", # Signed long type for pointer precision. Use when casting a pointer to a long to
# perform pointer arithmetic. BaseTsd.h:
#if defined(_WIN64) typedef __int64 LONG_PTR; #else typedef long LONG_PTR;
LPARAM: "l", # Message parameter. WinDef.h as follows: #typedef LONG_PTR LPARAM;
LPBOOL: "i", # Pointer to a BOOL. WinDef.h as follows: #typedef BOOL far *LPBOOL;
LPBYTE: "i", # Pointer to a BYTE. WinDef.h as follows: #typedef BYTE far *LPBYTE;
LPCSTR: "p", # Pointer to a constant null-terminated string of 8-bit Windows (ANSI) characters.
# See Character Sets Used By Fonts. http://msdn.microsoft.com/en-us/library/dd183415%28VS.85%29.aspx
LPCTSTR: "p", # An LPCWSTR if UNICODE is defined, an LPCSTR otherwise.
LPCVOID: "v", # Pointer to a constant of any type. WinDef.h as follows: typedef CONST void *LPCVOID;
LPCWSTR: "P", # Pointer to a constant null-terminated string of 16-bit Unicode characters.
LPDWORD: "p", # Pointer to a DWORD. WinDef.h as follows: typedef DWORD *LPDWORD;
LPHANDLE: "l", # Pointer to a HANDLE. WinDef.h as follows: typedef HANDLE *LPHANDLE;
LPINT: "I", # Pointer to an INT.
LPLONG: "L", # Pointer to an LONG.
LPSTR: "p", # Pointer to a null-terminated string of 8-bit Windows (ANSI) characters.
LPTSTR: "p", # An LPWSTR if UNICODE is defined, an LPSTR otherwise.
LPVOID: "v", # Pointer to any type.
LPWORD: "p", # Pointer to a WORD.
LPWSTR: "p", # Pointer to a null-terminated string of 16-bit Unicode characters.
LRESULT: "l", # Signed result of message processing. WinDef.h: typedef LONG_PTR LRESULT;
PBOOL: "i", # Pointer to a BOOL.
PBOOLEAN: "i", # Pointer to a BOOL.
PBYTE: "i", # Pointer to a BYTE.
PCHAR: "p", # Pointer to a CHAR.
PCSTR: "p", # Pointer to a constant null-terminated string of 8-bit Windows (ANSI) characters.
PCTSTR: "p", # A PCWSTR if UNICODE is defined, a PCSTR otherwise.
PCWSTR: "p", # Pointer to a constant null-terminated string of 16-bit Unicode characters.
PDWORD: "p", # Pointer to a DWORD.
PDWORDLONG: "L", # Pointer to a DWORDLONG.
PDWORD_PTR: "L", # Pointer to a DWORD_PTR.
PDWORD32: "L", # Pointer to a DWORD32.
PDWORD64: "L", # Pointer to a DWORD64.
PFLOAT: "L", # Pointer to a FLOAT.
PHALF_PTR: "L", # Pointer to a HALF_PTR.
PHANDLE: "L", # Pointer to a HANDLE.
PHKEY: "L", # Pointer to an HKEY.
PINT: "i", # Pointer to an INT.
PINT_PTR: "i", # Pointer to an INT_PTR.
PINT32: "i", # Pointer to an INT32.
PINT64: "i", # Pointer to an INT64.
PLCID: "l", # Pointer to an LCID.
PLONG: "l", # Pointer to a LONG.
PLONGLONG: "l", # Pointer to a LONGLONG.
PLONG_PTR: "l", # Pointer to a LONG_PTR.
PLONG32: "l", # Pointer to a LONG32.
PLONG64: "l", # Pointer to a LONG64.
POINTER_32: "l", # 32-bit pointer. On a 32-bit system, this is a native pointer. On a 64-bit system, this is a truncated 64-bit pointer.
POINTER_64: "l", # 64-bit pointer. On a 64-bit system, this is a native pointer. On a 32-bit system, this is a sign-extended 32-bit pointer.
POINTER_SIGNED: "l", # A signed pointer.
HPSS: "l",
POINTER_UNSIGNED: "l", # An unsigned pointer.
PSHORT: "l", # Pointer to a SHORT.
PSIZE_T: "l", # Pointer to a SIZE_T.
PSSIZE_T: "l", # Pointer to a SSIZE_T.
PSS_CAPTURE_FLAGS: "l",
PSTR: "p", # Pointer to a null-terminated string of 8-bit Windows (ANSI) characters. For more information, see Character Sets Used By Fonts.
PTBYTE: "p", # Pointer to a TBYTE.
PTCHAR: "p", # Pointer to a TCHAR.
PTSTR: "p", # A PWSTR if UNICODE is defined, a PSTR otherwise.
PUCHAR: "p", # Pointer to a UCHAR.
PUINT: "i", # Pointer to a UINT.
PUINT_PTR: "i", # Pointer to a UINT_PTR.
PUINT32: "i", # Pointer to a UINT32.
PUINT64: "i", # Pointer to a UINT64.
PULONG: "l", # Pointer to a ULONG.
PULONGLONG: "l", # Pointer to a ULONGLONG.
PULONG_PTR: "l", # Pointer to a ULONG_PTR.
PULONG32: "l", # Pointer to a ULONG32.
PULONG64: "l", # Pointer to a ULONG64.
PUSHORT: "l", # Pointer to a USHORT.
PVOID: "v", # Pointer to any type.
PWCHAR: "p", # Pointer to a WCHAR.
PWORD: "p", # Pointer to a WORD.
PWSTR: "p", # Pointer to a null- terminated string of 16-bit Unicode characters.
# For more information, see Character Sets Used By Fonts.
SC_HANDLE: "l", # (L) Handle to a service control manager database.
SERVICE_STATUS_HANDLE: "l", # (L) Handle to a service status value. See SCM Handles.
SHORT: "i", # A 16-bit integer. The range is –32768 through 32767 decimal.
SIZE_T: "l", # The maximum number of bytes to which a pointer can point. Use for a count that must span the full range of a pointer.
SSIZE_T: "l", # Signed SIZE_T.
TBYTE: "p", # A WCHAR if UNICODE is defined, a CHAR otherwise.TCHAR:
# http://msdn.microsoft.com/en-us/library/c426s321%28VS.80%29.aspx
TCHAR: "p", # A WCHAR if UNICODE is defined, a CHAR otherwise.TCHAR:
UCHAR: "p", # Unsigned CHAR (8 bit)
UHALF_PTR: "i", # Unsigned HALF_PTR. Use within a structure that contains a pointer and two small fields.
UINT: "i", # Unsigned INT. The range is 0 through 4294967295 decimal.
UINT_PTR: "i", # Unsigned INT_PTR.
UINT32: "i", # Unsigned INT32. The range is 0 through 4294967295 decimal.
UINT64: "i", # Unsigned INT64. The range is 0 through 18446744073709551615 decimal.
ULONG: "l", # Unsigned LONG. The range is 0 through 4294967295 decimal.
ULONGLONG: "l", # 64-bit unsigned integer. The range is 0 through 18446744073709551615 decimal.
ULONG_PTR: "l", # Unsigned LONG_PTR.
ULONG32: "i", # Unsigned INT32. The range is 0 through 4294967295 decimal.
ULONG64: "i", # Unsigned LONG64. The range is 0 through 18446744073709551615 decimal.
UNICODE_STRING: "P", # Pointer to some string structure??
USHORT: "i", # Unsigned SHORT. The range is 0 through 65535 decimal.
USN: "l", # Update sequence number (USN).
WCHAR: "i", # 16-bit Unicode character. For more information, see Character Sets Used By Fonts.
# In WinNT.h: typedef wchar_t WCHAR;
#WINAPI: K, # Calling convention for system functions. WinDef.h: define WINAPI __stdcall
WORD: "i", # 16-bit unsigned integer. The range is 0 through 65535 decimal.
WPARAM: "i", # Message parameter. WinDef.h as follows: typedef UINT_PTR WPARAM;
VOID: "v", # Any type ? Only use it to indicate no arguments or no return value
vKey: "i",
LPRECT: "p",
char: "p",
}
#----------------------------------------------------------------------------
# • [Array] : Get the specified values on method. After, check out each one if is
# String or Symbol.... If was Symbol will return at the specified value on
# the constant TYPES;
# Exemplo: types([:BOOL, :WCHAR]) # ["i", "i"]
#----------------------------------------------------------------------------
def types(import)
import2 = []
import.each { |i|
next if i.is_a?(NilClass) or i.is_a?(String)
import2 << TYPES[i]
}
return import2
end
#----------------------------------------------------------------------------
# • [INT] : Specific a function, with the value of importation and the DLL.
# For default, the DLL is the "user32".
#----------------------------------------------------------------------------
def int(function, import, dll="user32")
api = Win32API.new(dll, function, types(import), "i") rescue nil
return api unless block_given?
return Module.new {
yield.each { |key, value|
define_method(key) { |*vls|
vls = vls.is_a?(Array) ? vls : [vls]
value.collect! { |i| i = i.nil? ? vls.shift : i }
api.call(*value)
}
module_function key
} if yield.is_a?(Hash)
define_method(:call) { |*args| api.call(*args) }
module_function(:call)
}
end
alias :bool :int
#----------------------------------------------------------------------------
# • [LONG] : Specific a function, with the value of importation and the DLL.
# For default, the DLL is the "user32".
#----------------------------------------------------------------------------
def long(function, import, dll="user32")
api = Win32API.new(dll, function, types(import), "l") rescue nil
return api unless block_given?
return Module.new {
yield.each { |key, value|
define_method(key) { |*vls|
vls = vls.is_a?(Array) ? vls : [vls]
value.collect! { |i| i = i.nil? ? vls.shift : i }
api.call(*value)
}
module_function key
} if yield.is_a?(Hash)
define_method(:call) { |*args| api.call(*args) }
module_function(:call)
}
end
#----------------------------------------------------------------------------
# • [VOID] : Specific a function, with the value of importation and the DLL.
# For default, the DLL is the "user32".
#----------------------------------------------------------------------------
def void(function, import, dll="user32")
api = Win32API.new(dll, function, types(import), "v") rescue nil
return api unless block_given?
return Module.new {
yield.each { |key, value|