Files
Kristian Bendiksen 77c32a3fa5 #14772 Python: Add snapshot export object methods and forward exportSnapshots to them
- Add RimViewWindow_exportSnapshot on RimViewWindow (3D views and
  plots) with explicit ExportFolder, Prefix, Width, Height and
  FileFormat parameters. Generated as ViewWindow.export_snapshot().
- Add RimProject_exportSnapshots for exporting all views and/or plots
  with a ContentType parameter. Generated as Project.export_snapshots().
- Add RiaDefines::SnapshotFileFormat and SnapshotContentType enums,
  registered as Python StrEnums.
- Extract single-item exportSnapshotOfView()/exportSnapshotOfPlot()
  from the RicSnapshotAll*ToFileFeature loops so the object methods
  and the legacy loops share the implementation.
- RicfExportSnapshots resolves the export folder from the command file
  executor and forwards to the object methods.

Python: the hand-written ViewWindow.export_snapshot() wrapper is
removed (generated method is compatible). PlotWindow.export_snapshot()
and Project.export_snapshots() keep their legacy argument names
(file_prefix, output_format, snapshot_type, plot_format) as deprecated
aliases. Case.export_snapshots_of_all_views() is deprecated in favor
of View.export_snapshot().

Also fix Case.views(), which compared the view id to the case id and
therefore never returned any views.
2026-09-22 14:19:23 +02:00

61 lines
2.4 KiB
C++

/////////////////////////////////////////////////////////////////////////////////
//
// Copyright (C) 2026- Equinor ASA
//
// ResInsight is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// ResInsight 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 General Public License at <http://www.gnu.org/licenses/gpl.html>
// for more details.
//
/////////////////////////////////////////////////////////////////////////////////
#pragma once
#include "RiaDefines.h"
#include "cafAppEnum.h"
#include "cafPdmField.h"
#include "cafPdmObjectHandle.h"
#include "cafPdmObjectMethod.h"
#include <QString>
//==================================================================================================
/// Export a snapshot of a view window (3D view or plot) to a file in the given folder.
///
/// The file name is generated from the view window and prefixed with the given prefix. PDF output
/// is only supported for plots; 3D views are always exported as PNG. Requires a GUI.
//==================================================================================================
class RimViewWindow_exportSnapshot : public caf::PdmVoidObjectMethod
{
CAF_PDM_HEADER_INIT;
public:
RimViewWindow_exportSnapshot( caf::PdmObjectHandle* self );
void setExportFolder( const QString& exportFolder );
void setPrefix( const QString& prefix );
void setWidth( int width );
void setHeight( int height );
void setFileFormat( RiaDefines::SnapshotFileFormat fileFormat );
std::expected<caf::PdmObjectHandle*, QString> execute() override;
/// Resolve the export folder: an explicit folder if given, otherwise the project relative "snapshots" folder.
static QString resolveExportFolder( const QString& exportFolder );
private:
caf::PdmField<QString> m_exportFolder;
caf::PdmField<QString> m_prefix;
caf::PdmField<int> m_width;
caf::PdmField<int> m_height;
caf::PdmField<caf::AppEnum<RiaDefines::SnapshotFileFormat>> m_fileFormat;
};