view OrthancFramework/Sources/DataSource/TranscoderDataSource.h @ 7144:a2cd12438c41 default tip

fix comment
author Sebastien Jodogne <s.jodogne@gmail.com>
date Mon, 31 Aug 2026 09:16:01 +0200
parents ff382e45466a
children
line wrap: on
line source

/**
 * Orthanc - A Lightweight, RESTful DICOM Store
 * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics
 * Department, University Hospital of Liege, Belgium
 * Copyright (C) 2017-2023 Osimis S.A., Belgium
 * Copyright (C) 2024-2026 Orthanc Team SRL, Belgium
 * Copyright (C) 2021-2026 Sebastien Jodogne, ICTEAM UCLouvain, Belgium
 *
 * This program is free software: you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation, either version 3 of
 * the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this program. If not, see
 * <http://www.gnu.org/licenses/>.
 **/


#pragma once

#include "../DicomParsing/IDicomTranscoder.h"
#include "../FileStorage/FileInfo.h"
#include "../MultiThreading/Mutex.h"
#include "DataSourceAnswer.h"
#include "IDataSource.h"

#include <boost/shared_ptr.hpp>


namespace Orthanc
{
  class DataSourceReader;

  class ORTHANC_PUBLIC TranscoderDataSource : public IDataSource
  {
  private:
    class Value;
    class Identifier;

    boost::shared_ptr<IDicomTranscoder>  transcoder_;
    boost::shared_ptr<DataSourceReader>  storageAreaReader_;

  public:
    TranscoderDataSource(const boost::shared_ptr<IDicomTranscoder>& transcoder,
                         const boost::shared_ptr<DataSourceReader>& storageAreaReader);

    virtual IDynamicObject* Load(const IDataIdentifier& id,
                                 const boost::shared_ptr<SharedObjectCache>& readerCache /* could be NULL */) ORTHANC_OVERRIDE;

    virtual size_t GetValueSize(const IDynamicObject& value) const ORTHANC_OVERRIDE;

    class ORTHANC_PUBLIC Transcoded : public boost::noncopyable
    {
    private:
      std::unique_ptr<DataSourceAnswer::Item>  item_;   // Holding item puts backpressure on the data source

    public:
      explicit Transcoded(DataSourceAnswer::Item* item /* takes ownership */);

      class ORTHANC_PUBLIC LockAsParsed : public boost::noncopyable
      {
      private:
        /**
         * Access to the transcoded DICOM must be protected by a
         * mutex, as it could be shared by multiple threads if caching
         * is enabled in the DataSourceReader.
         **/

        std::unique_ptr<Mutex::ScopedLock>  lock_;
        std::unique_ptr<ParsedDicomFile>    parsed_;
        const ParsedDicomFile*              content_;

      public:
        explicit LockAsParsed(Transcoded& that);

        const ParsedDicomFile& GetContent() const
        {
          return *content_;
        }
      };

      class ORTHANC_PUBLIC LockAsBuffer : public boost::noncopyable
      {
      private:
        /**
         * Access to the transcoded DICOM must only be protected in
         * the constructor, if serialization to the buffer is required.
         **/

        std::unique_ptr<std::string>  serialized_;
        const std::string*            content_;

      public:
        explicit LockAsBuffer(Transcoded& that);

        const std::string& GetContent() const
        {
          return *content_;
        }
      };
    };

    static IDataIdentifier* CreateRequest(const FileInfo& attachment,
                                          DicomTransferSyntax targetSyntax,
                                          TranscodingSopInstanceUidMode mode,
                                          bool hasLossyQuality,
                                          unsigned int lossyQuality);

    static Transcoded* Execute(DataSourceReader& reader,
                               IDataIdentifier* request /* takes ownership */);
  };
}