Package omero.api

Interface _RenderingEngineOperations

  • All Superinterfaces:
    _PyramidServiceOperations, _ServiceInterfaceOperations, _StatefulServiceInterfaceOperations
    All Known Subinterfaces:
    RenderingEngine
    All Known Implementing Classes:
    _RenderingEngineDisp, _RenderingEngineTie, RenderingEngineI
    public interface _RenderingEngineOperations
extends _PyramidServiceOperations
    Defines a service to render a given pixels set. A pixels set is a 5D array that stores the pixels data of an image, that is the pixels intensity values. Every instance of this service is paired up to a pixels set. Use this service to transform planes within the pixels set onto an RGB image. The RenderingEngine allows to fine-tune the settings that define the transformation context, that is, a specification of how raw pixels data is to be transformed into an image that can be displayed on screen. Those settings are referred to as rendering settings or display options. After tuning those settings it is possible to save them to the metadata repository so that they can be used the next time the pixels set is accessed for rendering; for example by another RenderingEngine instance. Note that the display options are specific to the given pixels set and are experimenter scoped i.e. two different users can specify different display options for the same pixels set. (A RenderingEngine instance takes this into account automatically as it is always bound to a given experimenter.) This service is thread-safe.

    • Method Detail

      • render_async

        void render_async​(AMD_RenderingEngine_render __cb,
                  PlaneDef def,
                  Ice.Current __current)
           throws ServerError
        Renders the data selected by def according to the current rendering settings. The passed argument selects a plane orthogonal to one of the X, Y, or Z axes. How many wavelengths are rendered and what color model is used depends on the current rendering settings.
        Parameters:
        __cb - The callback object for the operation.
        def - Selects a plane orthogonal to one of the X, Y, or Z axes.
        __current - The Current object for the invocation.
        Throws:
        ValidationException - If def is null.
        ServerError

      • renderAsPackedInt_async

        void renderAsPackedInt_async​(AMD_RenderingEngine_renderAsPackedInt __cb,
                             PlaneDef def,
                             Ice.Current __current)
                      throws ServerError
        Renders the data selected by def according to the current rendering settings. The passed argument selects a plane orthogonal to one of the X, Y, or Z axes. How many wavelengths are rendered and what color model is used depends on the current rendering settings.
        Parameters:
        __cb - The callback object for the operation.
        def - Selects a plane orthogonal to one of the X, Y, or Z axes.
        __current - The Current object for the invocation.
        Throws:
        ValidationException - If def is null.
        ServerError

      • renderProjectedAsPackedInt_async

        void renderProjectedAsPackedInt_async​(AMD_RenderingEngine_renderProjectedAsPackedInt __cb,
                                      ProjectionType algorithm,
                                      int timepoint,
                                      int stepping,
                                      int start,
                                      int end,
                                      Ice.Current __current)
                               throws ServerError
        Performs a projection through selected optical sections of a particular timepoint with the currently active channels and renders the data for display.
        Parameters:
        __cb - The callback object for the operation.
        algorithm - IProjection.MAXIMUM_INTENSITY, IProjection.MEAN_INTENSITY or IProjection.SUM_INTENSITY.
        stepping - Stepping value to use while calculating the projection. For example, stepping=1 will use every optical section from start to end where stepping=2 will use every other section from start to end to perform the projection.
        start - Optical section to start projecting from.
        __current - The Current object for the invocation.
        Throws:
        ValidationException - Where:
        • algorithm is unknown
        • timepoint is out of range
        • start is out of range
        • end is out of range
        • start is greater than end
        ServerError

      • renderCompressed_async

        void renderCompressed_async​(AMD_RenderingEngine_renderCompressed __cb,
                            PlaneDef def,
                            Ice.Current __current)
                     throws ServerError
        Renders the data selected by def according to the current rendering settings and compresses the resulting RGBA composite image.
        Parameters:
        __cb - The callback object for the operation.
        def - Selects a plane orthogonal to one of the X, Y or Z axes.
        __current - The Current object for the invocation.
        Throws:
        ValidationException - If def is null.
        ServerError

      • renderProjectedCompressed_async

        void renderProjectedCompressed_async​(AMD_RenderingEngine_renderProjectedCompressed __cb,
                                     ProjectionType algorithm,
                                     int timepoint,
                                     int stepping,
                                     int start,
                                     int end,
                                     Ice.Current __current)
                              throws ServerError
        Performs a projection through selected optical sections of a particular timepoint with the currently active channels, renders the data for display and compresses the resulting RGBA composite image.
        Parameters:
        __cb - The callback object for the operation.
        algorithm - IProjection.MAXIMUM_INTENSITY, IProjection.MEAN_INTENSITY or IProjection.SUM_INTENSITY.
        stepping - Stepping value to use while calculating the projection. For example, stepping=1 will use every optical section from start to end where stepping=2 will use every other section from start to end to perform the projection.
        start - Optical section to start projecting from.
        __current - The Current object for the invocation.
        Throws:
        ValidationException - Where:
        • algorithm is unknown
        • timepoint is out of range
        • start is out of range
        • end is out of range
        • startis greater than end
        ServerError

      • getRenderingDefId_async

        void getRenderingDefId_async​(AMD_RenderingEngine_getRenderingDefId __cb,
                             Ice.Current __current)
                      throws ServerError
        Returns the id of the RenderingDef loaded by either lookupRenderingDef or loadRenderingDef.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • lookupPixels_async

        void lookupPixels_async​(AMD_RenderingEngine_lookupPixels __cb,
                        long pixelsId,
                        Ice.Current __current)
                 throws ServerError
        Loads the Pixels set this Rendering Engine is for.
        Parameters:
        __cb - The callback object for the operation.
        pixelsId - The pixels set ID.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • lookupRenderingDef_async

        void lookupRenderingDef_async​(AMD_RenderingEngine_lookupRenderingDef __cb,
                              long pixelsId,
                              Ice.Current __current)
                       throws ServerError
        Loads the rendering settings associated to the specified pixels set.
        Parameters:
        __cb - The callback object for the operation.
        pixelsId - The pixels set ID.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • loadRenderingDef_async

        void loadRenderingDef_async​(AMD_RenderingEngine_loadRenderingDef __cb,
                            long renderingDefId,
                            Ice.Current __current)
                     throws ServerError
        Loads a specific set of rendering settings that does not necessarily have to be linked to the given Pixels set. However, the rendering settings must be linked to a compatible Pixels set as defined by omero.api.IRenderingSettings.sanityCheckPixels.
        Parameters:
        __cb - The callback object for the operation.
        renderingDefId - The rendering definition ID.
        __current - The Current object for the invocation.
        Throws:
        ValidationException - If a RenderingDef does not exist with the ID renderingDefId or if the RenderingDef is incompatible due to differing pixels sets.
        ServerError

      • setOverlays_async

        void setOverlays_async​(AMD_RenderingEngine_setOverlays __cb,
                       RLong tablesId,
                       RLong imageId,
                       java.util.Map<java.lang.Long,​java.lang.Integer> rowColorMap,
                       Ice.Current __current)
                throws ServerError
        Deprecated.
        use omero::romio::PlaneDefWithMasks instead
        Informs the rendering engine that it should render a set of overlays on each rendered frame. These are expected to be binary masks.
        Parameters:
        __cb - The callback object for the operation.
        rowColorMap - Binary mask to color map.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • load_async

        void load_async​(AMD_RenderingEngine_load __cb,
                Ice.Current __current)
         throws ServerError
        Creates an instance of the rendering engine.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setModel_async

        void setModel_async​(AMD_RenderingEngine_setModel __cb,
                    RenderingModel model,
                    Ice.Current __current)
             throws ServerError
        Specifies the model that dictates how transformed raw data has to be mapped onto a color space.
        Parameters:
        __cb - The callback object for the operation.
        model - Identifies the color space model.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getModel_async

        void getModel_async​(AMD_RenderingEngine_getModel __cb,
                    Ice.Current __current)
             throws ServerError
        Returns the model that dictates how transformed raw data has to be mapped onto a color space.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getDefaultZ_async

        void getDefaultZ_async​(AMD_RenderingEngine_getDefaultZ __cb,
                       Ice.Current __current)
                throws ServerError
        Returns the index of the default focal section.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getDefaultT_async

        void getDefaultT_async​(AMD_RenderingEngine_getDefaultT __cb,
                       Ice.Current __current)
                throws ServerError
        Returns the default timepoint index.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setDefaultZ_async

        void setDefaultZ_async​(AMD_RenderingEngine_setDefaultZ __cb,
                       int z,
                       Ice.Current __current)
                throws ServerError
        Sets the index of the default focal section. This index is used to define a default plane.
        Parameters:
        __cb - The callback object for the operation.
        z - The value to set.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setDefaultT_async

        void setDefaultT_async​(AMD_RenderingEngine_setDefaultT __cb,
                       int t,
                       Ice.Current __current)
                throws ServerError
        Sets the default timepoint index. This index is used to define a default plane.
        Parameters:
        __cb - The callback object for the operation.
        t - The value to set.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getPixels_async

        void getPixels_async​(AMD_RenderingEngine_getPixels __cb,
                     Ice.Current __current)
              throws ServerError
        Returns the Pixels set the Rendering engine is for.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getAvailableModels_async

        void getAvailableModels_async​(AMD_RenderingEngine_getAvailableModels __cb,
                              Ice.Current __current)
                       throws ServerError
        Returns the list of color models supported by the Rendering engine.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getAvailableFamilies_async

        void getAvailableFamilies_async​(AMD_RenderingEngine_getAvailableFamilies __cb,
                                Ice.Current __current)
                         throws ServerError
        Returns the list of mapping families supported by the Rendering engine.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setQuantumStrategy_async

        void setQuantumStrategy_async​(AMD_RenderingEngine_setQuantumStrategy __cb,
                              int bitResolution,
                              Ice.Current __current)
                       throws ServerError
        Sets the quantization strategy. The strategy is common to all channels.
        Parameters:
        __cb - The callback object for the operation.
        bitResolution - The bit resolution defining associated to the strategy.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setCodomainInterval_async

        void setCodomainInterval_async​(AMD_RenderingEngine_setCodomainInterval __cb,
                               int start,
                               int end,
                               Ice.Current __current)
                        throws ServerError
        Sets the sub-interval of the device space i.e. a discrete sub-interval of \[0, 255].
        Parameters:
        __cb - The callback object for the operation.
        start - The lower bound of the interval.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getQuantumDef_async

        void getQuantumDef_async​(AMD_RenderingEngine_getQuantumDef __cb,
                         Ice.Current __current)
                  throws ServerError
        Returns the quantization object.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setQuantizationMap_async

        void setQuantizationMap_async​(AMD_RenderingEngine_setQuantizationMap __cb,
                              int w,
                              Family family,
                              double coefficient,
                              boolean noiseReduction,
                              Ice.Current __current)
                       throws ServerError
        Sets the quantization map, one per channel.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        coefficient - The coefficient identifying a curve in the family.
        noiseReduction - Pass true to turn the noise reduction algorithm on, false otherwise.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getChannelFamily_async

        void getChannelFamily_async​(AMD_RenderingEngine_getChannelFamily __cb,
                            int w,
                            Ice.Current __current)
                     throws ServerError
        Returns the family associated to the specified channel.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getChannelNoiseReduction_async

        void getChannelNoiseReduction_async​(AMD_RenderingEngine_getChannelNoiseReduction __cb,
                                    int w,
                                    Ice.Current __current)
                             throws ServerError
        Returns true if the noise reduction algorithm used to map the pixels intensity values is turned on, false if the algorithm is turned off. Each channel has an algorithm associated to it.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getChannelCurveCoefficient_async

        void getChannelCurveCoefficient_async​(AMD_RenderingEngine_getChannelCurveCoefficient __cb,
                                      int w,
                                      Ice.Current __current)
                               throws ServerError
        Returns the coefficient identifying a map in the family. Each channel has a map associated to it.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setChannelWindow_async

        void setChannelWindow_async​(AMD_RenderingEngine_setChannelWindow __cb,
                            int w,
                            double start,
                            double end,
                            Ice.Current __current)
                     throws ServerError
        Returns the pixels intensity interval. Each channel has a pixels intensity interval associated to it.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        end - The upper bound of the interval.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getChannelWindowStart_async

        void getChannelWindowStart_async​(AMD_RenderingEngine_getChannelWindowStart __cb,
                                 int w,
                                 Ice.Current __current)
                          throws ServerError
        Returns the lower bound of the pixels intensity interval. Each channel has a pixels intensity interval associated to it.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getChannelWindowEnd_async

        void getChannelWindowEnd_async​(AMD_RenderingEngine_getChannelWindowEnd __cb,
                               int w,
                               Ice.Current __current)
                        throws ServerError
        Returns the upper bound of the pixels intensity interval. Each channel has a pixels intensity interval associated to it.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setRGBA_async

        void setRGBA_async​(AMD_RenderingEngine_setRGBA __cb,
                   int w,
                   int red,
                   int green,
                   int blue,
                   int alpha,
                   Ice.Current __current)
            throws ServerError
        Sets the four components composing the color associated to the specified channel.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        green - The green component. A value between 0 and 255.
        alpha - The alpha component. A value between 0 and 255.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getRGBA_async

        void getRGBA_async​(AMD_RenderingEngine_getRGBA __cb,
                   int w,
                   Ice.Current __current)
            throws ServerError
        Returns a 4D-array representing the color associated to the specified channel. The first element corresponds to the red component (value between 0 and 255). The second corresponds to the green component (value between 0 and 255). The third corresponds to the blue component (value between 0 and 255). The fourth corresponds to the alpha component (value between 0 and 255).
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setActive_async

        void setActive_async​(AMD_RenderingEngine_setActive __cb,
                     int w,
                     boolean active,
                     Ice.Current __current)
              throws ServerError
        Maps the specified channel if true, unmaps the channel otherwise.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • isActive_async

        void isActive_async​(AMD_RenderingEngine_isActive __cb,
                    int w,
                    Ice.Current __current)
             throws ServerError
        Returns true if the channel is mapped, false otherwise.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • addCodomainMap_async

        void addCodomainMap_async​(AMD_RenderingEngine_addCodomainMap __cb,
                          CodomainMapContext mapCtx,
                          Ice.Current __current)
                   throws ServerError
        Deprecated.
        addCodomainMap() is deprecated. use addCodomainMapToChannel instead.
        Adds the context to the mapping chain. Only one context of the same type can be added to the chain. The codomain transformations are functions from the device space to device space. Each time a new context is added, the second LUT is rebuilt.
        Parameters:
        __cb - The callback object for the operation.
        mapCtx - The context to add.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • updateCodomainMap_async

        void updateCodomainMap_async​(AMD_RenderingEngine_updateCodomainMap __cb,
                             CodomainMapContext mapCtx,
                             Ice.Current __current)
                      throws ServerError
        Deprecated.
        removeCodomainMap() is deprecated.
        Updates the specified context. The codomain chain already contains the specified context. Each time a new context is updated, the second LUT is rebuilt.
        Parameters:
        __cb - The callback object for the operation.
        mapCtx - The context to update.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • removeCodomainMap_async

        void removeCodomainMap_async​(AMD_RenderingEngine_removeCodomainMap __cb,
                             CodomainMapContext mapCtx,
                             Ice.Current __current)
                      throws ServerError
        Deprecated.
        removeCodomainMap() is deprecated. use removeCodomainMapFromChannel instead.
        Removes the specified context from the chain. Each time a new context is removed, the second LUT is rebuilt.
        Parameters:
        __cb - The callback object for the operation.
        mapCtx - The context to remove.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • addCodomainMapToChannel_async

        void addCodomainMapToChannel_async​(AMD_RenderingEngine_addCodomainMapToChannel __cb,
                                   CodomainMapContext mapCtx,
                                   int w,
                                   Ice.Current __current)
                            throws ServerError
        Adds the context to the mapping chain. Only one context of the same type can be added to the chain. The codomain transformations are functions from the device space to device space. Each time a new context is added, the second LUT is rebuilt.
        Parameters:
        __cb - The callback object for the operation.
        mapCtx - The context to add.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • removeCodomainMapFromChannel_async

        void removeCodomainMapFromChannel_async​(AMD_RenderingEngine_removeCodomainMapFromChannel __cb,
                                        CodomainMapContext mapCtx,
                                        int w,
                                        Ice.Current __current)
                                 throws ServerError
        Removes the specified context from the chain. Each time a new context is removed, the second LUT is rebuilt.
        Parameters:
        __cb - The callback object for the operation.
        mapCtx - The context to remove.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • updateSettings_async

        void updateSettings_async​(AMD_RenderingEngine_updateSettings __cb,
                          RenderingDef settings,
                          Ice.Current __current)
                   throws ServerError
        Updates the current rendering settings based on a provided rendering definition and associated sub-objects.
        Parameters:
        __cb - The callback object for the operation.
        settings - Rendering definition to copy from. Each sub-object will be processed as though the specific method was called with related attributes provided as arguments. The following methods are called underneath:
        • RenderingEngine.setModel
        • RenderingEngine.setDefaultZ
        • RenderingEngine.setDefaultT
        • RenderingEngine.setQuantumStrategy
        • RenderingEngine.setCodomainInterval
        • RenderingEngine.setActive
        • RenderingEngine.setChannelWindow
        • RenderingEngine.setQuantizationMap
        • RenderingEngine.setRGBA
        • RenderingEngine.setChannelLookupTable
        If one or more attributes that apply to a particular method are null it will be skipped in its entirety. The underlying Renderer is not able to handle partial field updates. Furthermore, ChannelBinding references that are null and indexes in the RenderingDef.WAVERENDERING array greater than the currently looked up Pixels.SIZEC will be skipped.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • saveCurrentSettings_async

        void saveCurrentSettings_async​(AMD_RenderingEngine_saveCurrentSettings __cb,
                               Ice.Current __current)
                        throws ServerError
        Saves the current rendering settings in the database.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • resetDefaultSettings_async

        void resetDefaultSettings_async​(AMD_RenderingEngine_resetDefaultSettings __cb,
                                boolean save,
                                Ice.Current __current)
                         throws ServerError
        Resets the default settings i.e. the default values internal to the Rendering engine. The settings will be saved.
        Parameters:
        __cb - The callback object for the operation.
        save - Pass true to save the settings, false otherwise.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • setCompressionLevel_async

        void setCompressionLevel_async​(AMD_RenderingEngine_setCompressionLevel __cb,
                               float percentage,
                               Ice.Current __current)
                        throws ServerError
        Sets the current compression level for the service. (The default is 85%)
        Parameters:
        __cb - The callback object for the operation.
        percentage - A percentage compression level from 1.00 (100%) to 0.01 (1%).
        __current - The Current object for the invocation.
        Throws:
        ValidationException - if the percentage is out of range.
        ServerError

      • getCompressionLevel_async

        void getCompressionLevel_async​(AMD_RenderingEngine_getCompressionLevel __cb,
                               Ice.Current __current)
                        throws ServerError
        Returns the current compression level for the service.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • isPixelsTypeSigned_async

        void isPixelsTypeSigned_async​(AMD_RenderingEngine_isPixelsTypeSigned __cb,
                              Ice.Current __current)
                       throws ServerError
        Returns true if the pixels type is signed, false otherwise.
        Parameters:
        __cb - The callback object for the operation.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getPixelsTypeUpperBound_async

        void getPixelsTypeUpperBound_async​(AMD_RenderingEngine_getPixelsTypeUpperBound __cb,
                                   int w,
                                   Ice.Current __current)
                            throws ServerError
        Returns the minimum value for that channels depending on the pixels type and the original range (globalmin, globalmax)
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getPixelsTypeLowerBound_async

        void getPixelsTypeLowerBound_async​(AMD_RenderingEngine_getPixelsTypeLowerBound __cb,
                                   int w,
                                   Ice.Current __current)
                            throws ServerError
        Returns the maximum value for that channels depending on the pixels type and the original range (globalmin, globalmax)
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError

      • getCodomainMapContext_async

        void getCodomainMapContext_async​(AMD_RenderingEngine_getCodomainMapContext __cb,
                                 int w,
                                 Ice.Current __current)
                          throws ServerError
        Returns the list of codomain contexts for the specified channel.
        Parameters:
        __cb - The callback object for the operation.
        w - The channel index.
        __current - The Current object for the invocation.
        Throws:
        ServerError