API reference - Class ImageDataMappingNotation used in Ruby API documentation Description: A structure describing the data mapping of an image object
Data mapping is the process of transforming the data into RGB pixel values. This implementation provides four adjustment steps: first, in the case of monochrome data, the data is converted to a RGB triplet using the color map. The default color map will copy the value to all channels rendering a gray scale. After having normalized the data to 0..1 cooresponding to the min_value and max_value settings of the image, a color channel-independent brightness and contrast adjustment is applied. Then, a per-channel multiplier (red_gain, green_gain, blue_gain) is applied. Finally, the gamma function is applied and the result converted into a 0..255 pixel value range and clipped. Public constructors
Public methods
Deprecated methods (protected, public, static, non-static and constructors)
Detailed descriptionvoid _createDescription: Ensures the C++ object is created Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created. void _destroyDescription: Explicitly destroys the object Explicitly destroys the object on C++ side if it was owned by the script interpreter. Subsequent access to this object will throw an exception. If the object is not owned by the script, this method will do nothing. [const] bool _destroyed?Description: Returns a value indicating whether the object was already destroyed This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself. [const] bool _is_const_object?Description: Returns a value indicating whether the reference is a const reference This method returns true, if self is a const reference. In that case, only const methods may be called on self. void _manageDescription: Marks the object as managed by the script side. After calling this method on an object, the script side will be responsible for the management of the object. This method may be called if an object is returned from a C++ function and the object is known not to be owned by any C++ instance. If necessary, the script side may delete the object if the script's reference is no longer required. Usually it's not required to call this method. It has been introduced in version 0.24. void _unmanageDescription: Marks the object as no longer owned by the script side. Calling this method will make this object no longer owned by the script's memory management. Instead, the object must be managed in some other way. Usually this method may be called if it is known that some C++ object holds and manages this object. Technically speaking, this method will turn the script's reference into a weak reference. After the script engine decides to delete the reference, the object itself will still exist. If the object is not managed otherwise, memory leaks will occur. Usually it's not required to call this method. It has been introduced in version 0.24. void add_colormap_entry(double value,unsigned int color)Description: Add a colormap entry for this data mapping object.
This settings establishes a color mapping for a given value in the monochrome channel. The color must be given as a 32 bit integer, where the lowest order byte describes the blue component (0 to 255), the second byte the green component and the third byte the red component, i.e. 0xff0000 is red and 0x0000ff is blue. void assign(const ImageDataMapping other)Description: Assigns another object to self [const] double blue_gainDescription: The blue channel gain This value is the multiplier by which the blue channel is scaled after applying false color transformation and contrast/brightness/gamma. 1.0 is a neutral value. The gain should be >=0.0. Python specific notes:The object exposes a readable attribute 'blue_gain'. This is the getter. void blue_gain=(double blue_gain)Description: Set the blue_gain See blue_gain for a description of this property. Python specific notes:The object exposes a writable attribute 'blue_gain'. This is the setter. [const] double brightnessDescription: The brightness value The brightness is a double value between roughly -1.0 and 1.0. Neutral (original) brightness is 0.0. Python specific notes:The object exposes a readable attribute 'brightness'. This is the getter. void brightness=(double brightness)Description: Set the brightness See brightness for a description of this property. Python specific notes:The object exposes a writable attribute 'brightness'. This is the setter. void clear_colormapDescription: The the color map of this data mapping object. [const] unsigned int colormap_color(unsigned long n)Description: Returns the color for a given color map entry.
[const] double colormap_value(unsigned long n)Description: Returns the vlue for a given color map entry.
[const] double contrastDescription: The contrast value The contrast is a double value between roughly -1.0 and 1.0. Neutral (original) contrast is 0.0. Python specific notes:The object exposes a readable attribute 'contrast'. This is the getter. void contrast=(double contrast)Description: Set the contrast See contrast for a description of this property. Python specific notes:The object exposes a writable attribute 'contrast'. This is the setter. void createDescription: Ensures the C++ object is created Use of this method is deprecated. Use _create instead void destroyDescription: Explicitly destroys the object Use of this method is deprecated. Use _destroy instead [const] bool destroyed?Description: Returns a value indicating whether the object was already destroyed Use of this method is deprecated. Use _destroyed? instead [const] new ImageDataMapping ptr dupDescription: Creates a copy of self [const] double gammaDescription: The gamma value The gamma value allows to adjust for non-linearities in the display chain and to enhance contrast. A value for linear intensity reproduction on the screen is roughly 0.5. The exact value depends on the monitor calibration. Values below 1.0 give a "softer" appearance while values above 1.0 give a "harder" appearance. Python specific notes:The object exposes a readable attribute 'gamma'. This is the getter. void gamma=(double gamma)Description: Set the gamma See gamma for a description of this property. Python specific notes:The object exposes a writable attribute 'gamma'. This is the setter. [const] double green_gainDescription: The green channel gain This value is the multiplier by which the green channel is scaled after applying false color transformation and contrast/brightness/gamma. 1.0 is a neutral value. The gain should be >=0.0. Python specific notes:The object exposes a readable attribute 'green_gain'. This is the getter. void green_gain=(double green_gain)Description: Set the green_gain See green_gain for a description of this property. Python specific notes:The object exposes a writable attribute 'green_gain'. This is the setter. [const] bool is_const_object?Description: Returns a value indicating whether the reference is a const reference Use of this method is deprecated. Use _is_const_object? instead [static] new ImageDataMapping ptr newDescription: Create a new data mapping object with default settings Python specific notes:This method is the default initializer of the object [const] unsigned long num_colormap_entriesDescription: Returns the current number of color map entries.
[const] double red_gainDescription: The red channel gain This value is the multiplier by which the red channel is scaled after applying false color transformation and contrast/brightness/gamma. 1.0 is a neutral value. The gain should be >=0.0. Python specific notes:The object exposes a readable attribute 'red_gain'. This is the getter. void red_gain=(double red_gain)Description: Set the red_gain See red_gain for a description of this property. Python specific notes:The object exposes a writable attribute 'red_gain'. This is the setter. |