dummy_extended_4ruby-alpha0.1.3 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 106cb313b1df35d0331265bc2e6c080aab860970
-  data.tar.gz: 7c4500d0f86d9bf0d6af4e8ba3e07560f0c162e8
+  metadata.gz: 07b8749021d8d291066e49152a9089ba4375020e
+  data.tar.gz: 13edba9511a53f74f153767e300eb0e7adf1a6e4
 SHA512:
-  metadata.gz: 4fdc1509616f7755970f0e4cfefd8ba3f8dbbc005f954b731632f8a8f8b6b306ed87f63e13d1369b8a12ea51c2b837124769d12cb5ec943f44571844cd27064c
-  data.tar.gz: e33158109742604c37ddab0f7529e504dc57a80c216484f9585ed69c16aaabced2b8364bef1390a09bc3b64620f3ef17dad207476e1ae0082b28e42f5ad456c7
+  metadata.gz: cd3a6d052e155a93f9dc792f4c281c360a82bead6991bb4a3294c20c3641d1c93ddba321aa89eab629a190f213a94614695f6562ea099e7dba16ef5af7ca83df
+  data.tar.gz: db2bb516a067df812e4977522dfa275e941c76dde678fb289cc55ab769ded630565bfa7369d28237fce5abd3e5dd9d1ee9f27a680e89aa81346b936c5da2c4a8

data/lib/dummy_extended_4ruby-alpha0.1.3.rb

@@ -17,4 +17,21 @@
 		bad doclink : DOCLINK_NOT_FOUND
 =end
 
-require "dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby"
+
+if (RUBY_VERSION < '1.9.0')
+    raise FatalError.new("This gem does not support the running Ruby Version (too old)")
+elsif (RUBY_VERSION[0] == '2' &&  RUBY_VERSION[2] == '4')
+    require "dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_4"
+elsif (RUBY_VERSION[0] == '2' &&  RUBY_VERSION[2] == '3')
+    require "dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_3"
+elsif (RUBY_VERSION[0] == '2' &&  RUBY_VERSION[2] == '2')
+    require "dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_2"
+elsif (RUBY_VERSION[0] == '2' &&  RUBY_VERSION[2] == '1')
+    require "dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_1"
+elsif (RUBY_VERSION[0] == '2' &&  RUBY_VERSION[2] == '0')
+    require "dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_0"
+elsif (RUBY_VERSION[0] == '1' &&  RUBY_VERSION[2] == '9')
+    require "dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_1_9"
+else
+    raise FatalError.new("This gem does not support yet the running Ruby Version")
+end

data/lib/interface_file/dummy_extended_4ruby-alpha0.1.3_interface_file.rb

@@ -0,0 +1,824 @@
+=begin
+    This interface file for the Ruby Wrapper serves as a reference for calling the functions of the dummy_extended C Upil Library.
+    It also describes the usable constants and enumerations.
+    It is provided for information purposes only and must not be included in your source code.
+=end
+
+
+=begin
+    Dummy_Extended library
+
+    @version	alpha0.1.3
+    @status		Internal testing
+
+    @copyright	OP3FT 2012-2017
+
+ * This is a dummy_extended library which permits to do dummy_extended things that
+ * are not available in the other dummy_extended libraries.
+ *	   bad doclink : DOCLINK_NOT_FOUND
+=end
+
+
+module XXX
+    include XXX
+
+/**
+ * Library section
+ * This section covers library initialization and finalization.
+ *
+ */
+
+/* Beginning of section: Library section */
+
+/**
+ * Library States
+ * Library states returned by the @see library_get_state() function.
+ */
+
+/**
+ * Undefined
+ * Undefined.
+ * @value 1010000
+ */
+const LIBRARY_STATE_UNDEFINED = 1010000;
+
+/**
+ * Not initialized
+ * Library is not initialized.
+ * @value 1010001
+ */
+const LIBRARY_STATE_NOT_INITIALIZED = 1010001;
+
+/**
+ * initialization has failed
+ * The initialization of the library failed.
+ * @value 1010002
+ */
+const LIBRARY_STATE_INITIALIZATION_HAS_FAILED = 1010002;
+
+/**
+ * Initialized
+ * Library is initialized.
+ * @value 1010003
+ */
+const LIBRARY_STATE_INITIALIZED = 1010003;
+
+/**
+ * Finalization has failed
+ * The finalization of the library failed.
+ * @value 1010004
+ */
+const LIBRARY_STATE_FINALIZATION_HAS_FAILED = 1010004;
+
+/**
+ * Finalized
+ * Library is finalized.
+ * @value 1010005
+ */
+const LIBRARY_STATE_FINALIZED = 1010005;
+
+
+/**
+ * Library initialization errors
+ * Library initialization errors returned by the @see library_get_state() function.
+ */
+
+/**
+ * Undefined
+ * Undefined.
+ * @value 1020000
+ */
+const LIBRARY_INITIALIZATION_ERROR_UNDEFINED = 1020000;
+
+/**
+ * Invalid state
+ * Invalid state.
+ * @value 1020001
+ */
+const LIBRARY_INITIALIZATION_ERROR_INVALID_STATE = 1020001;
+
+/**
+ * NULL parameter
+ * NULL parameter.
+ * @value 1020002
+ */
+const LIBRARY_INITIALIZATION_ERROR_NULL_PARAMETER = 1020002;
+
+/**
+ * Invalid library version length
+ * Invalid library version length.
+ * @value 1020003
+ */
+const LIBRARY_INITIALIZATION_ERROR_INVALID_LIBRARY_VERSION_LENGTH = 1020003;
+
+/**
+ * Invalid library version
+ * Version of the library is invalid.
+ * @value 1020004
+ */
+const LIBRARY_INITIALIZATION_ERROR_INVALID_LIBRARY_VERSION = 1020004;
+
+/**
+ * FCT fleet is already cruising
+ * FCT fleet is already cruising.
+ * @value 1020005
+ */
+const LIBRARY_INITIALIZATION_ERROR_FCT_FLEET_IS_ALREADY_CRUISING = 1020005;
+
+/**
+ * FCT takeoff has failed
+ * FCT takeoff has failed.
+ * @value 1020006
+ */
+const LIBRARY_INITIALIZATION_ERROR_FCT_TAKEOFF_HAS_FAILED = 1020006;
+
+/**
+ * No error
+ * No library initialization error.
+ * @value 1020007
+ */
+const LIBRARY_INITIALIZATION_ERROR_NO_ERROR = 1020007;
+
+/**
+ * Internal range begin
+ * Start of the internal range of library-initialization errors.
+ * @value 1021000
+ */
+const LIBRARY_INITIALIZATION_ERROR_INTERNAL_RANGE_BEGIN = 1021000;
+
+
+/**
+ * Library finalization errors
+ * Library finalization errors returned by the @see library_get_state() function.
+ */
+
+/**
+ * Undefined
+ * Undefined.
+ * @value 1030000
+ */
+const LIBRARY_FINALIZATION_ERROR_UNDEFINED = 1030000;
+
+/**
+ * Invalid state
+ * Invalid state.
+ * @value 1030001
+ */
+const LIBRARY_FINALIZATION_ERROR_INVALID_STATE = 1030001;
+
+/**
+ * FCT fleet is not cruising
+ * FCT fleet is not cruising.
+ * @value 1030002
+ */
+const LIBRARY_FINALIZATION_ERROR_FCT_FLEET_IS_NOT_CRUISING = 1030002;
+
+/**
+ * FCT fleet is still cruising
+ * FCT fleet is still cruising (finalize should be call by the same thread than initialize).
+ * @value 1030003
+ */
+const LIBRARY_FINALIZATION_ERROR_FCT_FLEET_IS_STILL_CRUISING = 1030003;
+
+/**
+ * No error
+ * No library finalization error.
+ * @value 1030004
+ */
+const LIBRARY_FINALIZATION_ERROR_NO_ERROR = 1030004;
+
+/**
+ * Internal range begin
+ * Start of the internal range of library-finalization errors.
+ * @value 1031000
+ */
+const LIBRARY_FINALIZATION_ERROR_INTERNAL_RANGE_BEGIN = 1031000;
+
+
+/**
+ * Get library state
+ *
+ * Gets the library state.
+ *
+
+ * @return bool	   Return value	   Returns true if the function succeeds, false if the
+ * function fails.
+ */
+function library_get_state (&$libraryState,
+							&$initializationError,
+							&$finalizationError)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Undefined free ID
+ * Undefined free ID.
+ * It has to be verified that the variable that will be passed as parameter
+ * to a 'library-free-arguments' function call is different to this value
+ * @value 0
+ */
+const FREE_ID_UNDEFINED = 0;
+
+/* End of section: Library section */
+
+/**
+ * First section
+ * This is a multiline comment.
+ * This should be on the second line
+ * See this enumeration: @see AN_ENUMERATION_....
+ *
+ */
+
+/* Beginning of section: First section */
+
+/* Beginning of subsection: First subsection */
+
+/**
+ * The answer to THE question
+ * You should read THE book to understand.
+ * See this value: @see AN_ENUMERATION_ZERO.
+ * @value 42
+ */
+const A_CONSTANT = 42;
+
+/**
+ * Max item count in the collection
+ * Same as the total number of fingers we have:
+ *	   - Left hand
+ *	   - Right hand
+ * See this constant: @see A_CONSTANT.
+ * @value 10
+ */
+const COLLECTION_COUNT_MAX = 10;
+
+/**
+ * Details on an-enumeration
+ * This is a short comment. doclink : @see A_DUPLICATED_ENUMERATION_...
+ */
+
+/**
+ * Zero
+ * This is less than one.
+ * Same as nothing...
+ * doclink : @see library_initialize()
+ * @value 10
+ */
+const AN_ENUMERATION_ZERO = 10;
+
+/**
+ * One
+ * Is this a prime?
+ * I'll never know...
+ * @value 11
+ */
+const AN_ENUMERATION_ONE = 11;
+
+/**
+ * One plus one
+ * Can you count?
+ * I can!
+ * @value 12
+ */
+const AN_ENUMERATION_TWO = 12;
+
+/**
+ * Three
+ * Same as the number
+ * of lines in
+ * this comment
+ * @value 13
+ */
+const AN_ENUMERATION_THREE = 13;
+
+
+/**
+ * A duplicated enumeration
+ * You should not repeat yourself... See this keyword: null
+ */
+
+/**
+ * Zero
+ * This is less than one.
+ * Same as nothing...
+ * doclink : @see library_initialize()
+ * @value 10
+ */
+const A_DUPLICATED_ENUMERATION_ZERO = 10;
+
+/**
+ * One
+ * Is this a prime?
+ * I'll never know...
+ * @value 11
+ */
+const A_DUPLICATED_ENUMERATION_ONE = 11;
+
+/**
+ * One plus one
+ * Can you count?
+ * I can!
+ * @value 12
+ */
+const A_DUPLICATED_ENUMERATION_TWO = 12;
+
+/**
+ * Three
+ * Same as the number
+ * of lines in
+ * this comment
+ * @value 13
+ */
+const A_DUPLICATED_ENUMERATION_THREE = 13;
+
+
+/**
+ * Record without Objects
+ * This is the simplest record I could think of
+ * Also see this one: @see Image
+ */
+class RecordWithoutObjects
+{
+	/**
+	 * @var bool The boolean
+	 * See also: @see @see Image::$red
+	 */
+	public $theBoolean;
+
+	/**
+	 * @var bool The second boolean
+	 * See also: @see @see Image::$red
+	 */
+	public $theSecondBoolean;
+
+	/**
+	 * @var bool The third boolean
+	 * See also: @see @see Image::$red
+	 */
+	public $theThirdBoolean;
+
+	/**
+	 * @var int The 32 bits integer
+	 * We only deal with 32 bits values
+	 * We don't need more
+	 * See also: @see AN_ENUMERATION_THREE
+	 */
+	public $theInteger32;
+
+}
+
+/**
+ * Record of primitives
+ * This is the simplest record I could think of
+ * Also see this one: @see Image
+ */
+class RecordOfPrimitives
+{
+	/**
+	 * @var bool The boolean
+	 * See also: @see @see Image::$red
+	 */
+	public $theBoolean;
+
+	/**
+	 * @var int The 32 bits integer
+	 * We only deal with 32 bits values
+	 * We don't need more
+	 * See also: @see AN_ENUMERATION_THREE
+	 */
+	public $theInteger32;
+
+	/**
+	 * @var \Frogans\Upil\UpilBuffer The buffer
+	 * For storing arbitrary binary data
+	 */
+	public $theBuffer;
+
+}
+
+/**
+ * A bitmap image
+ * Each plane is stored in its own buffer.
+ * See also: @see @see RecordOfPrimitives::$theBuffer
+ */
+class Image
+{
+	/**
+	 * @var \Frogans\Upil\UpilBuffer The red plane
+	 * Beware of the bull
+	 */
+	public $red;
+
+	/**
+	 * @var \Frogans\Upil\UpilBuffer The green plane
+	 * The color of a frog...
+	 * ...ans?
+	 */
+	public $green;
+
+	/**
+	 * @var \Frogans\Upil\UpilBuffer The blue plane
+	 * The color of the sky
+	 * in good weather conditions
+	 */
+	public $blue;
+
+	/**
+	 * @var \Frogans\Upil\UpilBuffer The alpha plane
+	 * Visible or invisible
+	 * or anything in the middle
+	 */
+	public $alpha;
+
+	/**
+	 * @var null The strange one
+	 * A rather strange field in an image record...
+	 */
+	public $strange;
+
+}
+
+/**
+ * A collection of booleans
+ * So many of them...
+ * See also: @see @see Image::$green.
+ */
+class CollectionOfBoolean
+{
+	/**
+	* @var bool[] The items
+	*/
+	public $items;
+
+}
+
+/**
+ * A collection of 32 bits integers
+ * So many of them...
+ * See also: @see @see Image::$green.
+ */
+class CollectionOfInteger32
+{
+	/**
+	* @var int[] The items
+	*/
+	public $items;
+
+}
+
+/**
+ * A collection of buffers
+ * So many of them...
+ */
+class ColOfBuffers
+{
+	/**
+	* @var \Frogans\Upil\UpilBuffer[] The items
+	*/
+	public $items;
+
+}
+
+/**
+ * A collection of record of primitives
+ * See: @see RecordOfPrimitives.
+ */
+class CollectionOfRecordOfPrimitives
+{
+	/**
+	* @var null[] The items
+	*/
+	public $items;
+
+}
+
+/**
+ * A collection of collection of integer32
+ * So many of them...
+ */
+class CollectionOfCollectionOfInteger32
+{
+	/**
+	* @var null[] The items
+	*/
+	public $items;
+
+}
+
+/**
+ * A collection of collection of record of primitives
+ * So many of them...
+ */
+class CollectionOfCollectionOfRecordOfPrimitives
+{
+	/**
+	* @var null[] The items
+	*/
+	public $items;
+
+}
+
+/**
+ * Record of non-primitive types
+ * Not trivial
+ */
+class RecordOfNonPrimitives
+{
+	/**
+	 * @var null The collection of 32 bits integers
+	 * This is too short comment
+	 */
+	public $theColOfInt;
+
+	/**
+	 * @var null The collection of buffers
+	 * This is too short comment
+	 */
+	public $theColOfBuffer;
+
+	/**
+	 * @var null The record
+	 * This is a short comment
+	 */
+	public $theRec;
+
+}
+
+/**
+ * Copy a boolean
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function copy_boolean ($orig,
+					   &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Copy a the first 32 bits integers and add it with the second integer
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return int The value of the sum	   So any integer32
+ */
+function copy_integer32_and_add ($orig1,
+								 $orig2,
+								 &$copy1,
+								 &$copy2)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Waits for the specific following buffer [1,2,3,4,5]
+ *
+ * And only this one!
+ *
+
+ * @return bool	   Does the buffer pass the test?  true if success, false otherwise
+ */
+function test_the_buffer (UpilBuffer $tested_buffer)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Deeply copies a buffer
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_buffer (UpilBuffer $orig,
+						  UpilBuffer &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Copies a record without objects
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function copy_record_without_objects (null $orig,
+									  null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Deeply copies a record of primitives
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_record_of_primitives (null $orig,
+										null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Deeply copies a collection of boolean
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_collection_of_boolean (null $orig,
+										 null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Deeply copies a collection of 32 bits integers
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_collection_of_integer32 (null $orig,
+										   null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Deeply copies a collection of buffers
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_collection_of_buffers (null $orig,
+										 null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Deeply copies a collection of record of primitives
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_collection_of_record_of_primitives (null $orig,
+													  null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Deeply copies a collection of collection of integer32
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_collection_of_collection_of_integer32 (null $orig,
+														 null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Create a collection of collection of record of primitives from two collections of record of primitives
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_collection_of_collection_of_record_of_primitives (null $orig,
+																	null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Deeply copies a record of non primitives
+ *
+ * This is a multiline comment.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function deepcopy_record_of_non_primitives (null $orig,
+											null &$copy)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Get a 320x480 image
+ *
+ * This function can be use for efficiency measurement.
+ * This should be on the second line
+ * this should be on the third.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function get_image_320x480 (null &$image)
+{
+	/* See note at the beginning of this file */
+}
+
+/**
+ * Mixing Things Together
+ *
+ * Used to test if everything goes right with different in and out parameters of different type passed in random order.
+ * This is not about copy but about composition / decomposition.
+ * Look at the name to understand what is used to build what.
+ *
+
+ * @return bool	   The return value	   true if success, false otherwise
+ */
+function mixing_things_together ($b,
+								 null &$aBC,
+								 UpilBuffer $c,
+								 $a,
+								 UpilBuffer &$f,
+								 &$d,
+								 null $dEF,
+								 &$e,
+								 null $gHI,
+								 &$g,
+								 &$i,
+								 &$h,
+								 UpilBuffer $j,
+								 UpilBuffer $k,
+								 null &$cJK,
+								 null $lM,
+								 null &$m,
+								 null &$l,
+								 null $nOP,
+								 UpilBuffer &$p,
+								 UpilBuffer &$n,
+								 UpilBuffer &$o,
+								 null $qR,
+								 null &$q,
+								 null &$r)
+{
+	/* See note at the beginning of this file */
+}
+
+/* End of subsection: First subsection */
+
+/* Beginning of subsection: Second subsection */
+
+/**
+ * Maximum heap size
+ * The heap size should not go above this limit
+ * @value 65536
+ */
+const MAX_HEAP_SIZE = 65536;
+
+/* End of subsection: Second subsection */
+
+/* End of section: First section */
+
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dummy_extended_4ruby-alpha0.1.3
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - OP3FT
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 1.0.1
 description: This module wraps the dummy_extended library allowing to access it from
   Ruby applications
 email: x.x@op3ft.org
@@ -32,8 +32,14 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/dummy_extended_4ruby-alpha0.1.3.rb
-- lib/dummy_extended_4ruby-alpha0.1.3/Library/libdummy_extended-alpha0.1.3.so
-- lib/dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby.so
+- lib/dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_1_9.so
+- lib/dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_0.so
+- lib/dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_1.so
+- lib/dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_2.so
+- lib/dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_3.so
+- lib/dummy_extended_4ruby-alpha0.1.3/dummy_extended_4ruby_2_4.so
+- lib/dummy_extended_4ruby-alpha0.1.3/libdummy_extended-alpha0.1.3.so
+- lib/interface_file/dummy_extended_4ruby-alpha0.1.3_interface_file.rb
 homepage: http://www.frogans.org
 licenses:
 - Nonstandard