Class ImagePixelWriteAccessor

Modules/Core/include/mitkImagePixelWriteAccessor.h:33–141

   */
  template <class TPixel, unsigned int VDimension = 3>
  class ImagePixelWriteAccessor : public ImagePixelAccessor<TPixel, VDimension>
  {
    friend class Image;

  public:
    typedef ImagePixelAccessor<TPixel, VDimension> ImagePixelAccessorType;
    typedef itk::SmartPointer<mitk::Image> ImagePointer;

    /** \brief Instantiates a mitk::ImageWriteAccessor (see its doxygen page for more details)
     *  \param iP specifies the associated Image
     *  \param iDI specifies the allocated image part
     *  \param OptionFlags properties from mitk::ImageAccessorBase::Options can be chosen and assembled with bitwise
     * unification.
     *  \throws mitk::Exception if the Constructor was created inappropriately
     *  \throws mitk::MemoryIsLockedException if requested image area is exclusively locked and
     * mitk::ImageAccessorBase::ExceptionIfLocked is set in OptionFlags
     *
     *   Includes a check if typeid of PixelType coincides with templated TPixel
     *   and a check if VDimension equals to the Dimension of the Image.
     *
     *  \note
     *  To avoid intermittent Update() calls to a predecessing filter pipeline, a call to Modified() method after the
     * access is finished is left to the developer.
     */
    ImagePixelWriteAccessor(ImagePointer iP,
                            const ImageDataItem *iDI = nullptr,
                            int OptionFlags = ImageAccessorBase::DefaultBehavior)
      : ImagePixelAccessor<TPixel, VDimension>(iP.GetPointer(), iDI), m_WriteAccessor(iP, iDI, OptionFlags)
    {
    }

    /** \brief Gives full data access. */
    virtual inline TPixel *GetData() const { return static_cast<TPixel *>(m_WriteAccessor.m_AddressBegin); }
    /** \brief Sets a pixel value at the given index. */
    void SetPixelByIndex(const itk::Index<VDimension> &idx, const TPixel &value)
    {
      unsigned int offset = ImagePixelAccessor<TPixel, VDimension>::GetOffset(idx);

      *(((TPixel *)m_WriteAccessor.m_AddressBegin) + offset) = value;
    }

    /** Extends SetPixel by integrating index validation to prevent overflow. */
    void SetPixelByIndexSafe(const itk::Index<VDimension> &idx, const TPixel &value)
    {
      unsigned int offset = ImagePixelAccessorType::GetOffset(idx);

      TPixel *targetAddress = ((TPixel *)m_WriteAccessor.m_AddressBegin) + offset;

      if (targetAddress >= m_WriteAccessor.m_AddressBegin && targetAddress < m_WriteAccessor.m_AddressEnd)
      {
        *targetAddress = value;
      }
      else
      {
        // printf("image dimensions = %d, %d, %d\n", imageDims[0], imageDims[1], imageDims[2]);
        // printf("m_AddressBegin: %p, m_AddressEnd: %p, offset: %u\n", m_WriteAccessor.m_AddressBegin,
        // m_WriteAccessor.m_AddressEnd, offset);
        mitkThrow() << "ImageAccessor Overflow: image access exceeds the requested image area at " << idx << ".";