/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2015-2016 Mario Luzeiro * Copyright (C) 1992-2021 KiCad Developers, see AUTHORS.txt for contributors. * * This program 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 2 * 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, you may find one here: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ #ifndef EDA_3D_CANVAS_H #define EDA_3D_CANVAS_H #include #include "board_adapter.h" #include "3d_rendering/raytracing/accelerators/accelerator_3d.h" #include "3d_rendering/render_3d_base.h" #include "3d_cache/3d_cache.h" #include #include #include class WX_INFOBAR; class wxStatusBar; class BOARD; class RENDER_3D_RAYTRACE; class RENDER_3D_OPENGL; /** * Implement a canvas based on a wxGLCanvas */ class EDA_3D_CANVAS : public HIDPI_GL_3D_CANVAS { public: /** * Create a new 3D Canvas with an attribute list. * * @param aParent the parent creator of this canvas. * @param aAttribList a list of openGL options created by GetOpenGL_AttributesList. * @param aBoard The board. * @param aSettings the settings options to be used by this canvas. */ EDA_3D_CANVAS( wxWindow* aParent, const int* aAttribList, BOARD_ADAPTER& aSettings, CAMERA& aCamera, S3D_CACHE* a3DCachePointer ); ~EDA_3D_CANVAS(); /** * Set a dispatcher that processes events and forwards them to tools. * * #DRAW_PANEL_GAL does not take over the ownership. Passing NULL disconnects all event * handlers from the DRAW_PANEL_GAL and parent frame. * * @param aEventDispatcher is the object that will be used for dispatching events. */ void SetEventDispatcher( TOOL_DISPATCHER* aEventDispatcher ); void SetStatusBar( wxStatusBar* aStatusBar ) { m_parentStatusBar = aStatusBar; } void SetInfoBar( WX_INFOBAR* aInfoBar ) { m_parentInfoBar = aInfoBar; } void ReloadRequest( BOARD* aBoard = nullptr, S3D_CACHE* aCachePointer = nullptr ); /** * Query if there is a pending reload request. * * @return true if it wants to reload, false if there is no reload pending. */ bool IsReloadRequestPending() const { if( m_3d_render ) return m_3d_render->IsReloadRequestPending(); else return false; } /** * @return the current render ( a RENDER_3D_RAYTRACE* or a RENDER_3D_OPENGL* render ) */ RENDER_3D_BASE* GetCurrentRender() const { return m_3d_render; } /** * Request to render the current view in Raytracing mode. */ void RenderRaytracingRequest(); /** * Request a screenshot and output it to the \a aDstImage * * @param aDstImage - Screenshot destination image */ void GetScreenshot( wxImage& aDstImage ); /** * Select a specific 3D view or operation * * @param aRequestedView the view to move to * @return true if the view request was handled, false if no command found for this view. */ bool SetView3D( VIEW3D_TYPE aRequestedView ); /** * Enable or disable camera animation when switching to a pre-defined view. */ void SetAnimationEnabled( bool aEnable ) { m_animation_enabled = aEnable; } bool GetAnimationEnabled() const { return m_animation_enabled; } /** * Set the camera animation moving speed multiplier option. * * @param aMultiplier one of the possible integer options: [1,2,3,4,5]. */ void SetMovingSpeedMultiplier( int aMultiplier ) { m_moving_speed_multiplier = aMultiplier; } int GetMovingSpeedMultiplier() const { return m_moving_speed_multiplier; } int GetProjectionMode() const { return (int) m_camera.GetProjection(); }; void SetProjectionMode( int aMode ) { m_camera.SetProjection( (PROJECTION_TYPE) aMode ); } /** * Notify that the render engine was changed. */ void RenderEngineChanged(); /** * Update the status bar with the position information. */ void DisplayStatus(); /** * Schedule a refresh update of the canvas. * * @param aRedrawImmediately true will request a redraw, false will schedule a redraw * after a short timeout. */ void Request_refresh( bool aRedrawImmediately = true ); /** * Used to forward events to the canvas from popups, etc. */ void OnEvent( wxEvent& aEvent ); /** * Get information used to display 3D board. */ const BOARD_ADAPTER& GetBoardAdapter() const { return m_boardAdapter; } /** * Get a value indicating whether to render the pivot. */ bool GetRenderPivot() { return m_render_pivot; } /** * Set aValue indicating whether to render the pivot. * * @param aValue true will cause the pivot to be rendered on the next redraw. */ void SetRenderPivot( bool aValue ) { m_render_pivot = aValue; } /** * Get a value indicating whether to render the 3dmouse pivot. */ bool GetRender3dmousePivot() { return m_render3dmousePivot; } /** * Set aValue indicating whether to render the 3dmouse pivot. * * @param aValue true will cause the pivot to be rendered on the next redraw. */ void SetRender3dmousePivot( bool aValue ) { m_render3dmousePivot = aValue; } /** * Set the position of the the 3dmouse pivot. * * @param aPos is the position of the 3dmouse rotation pivot */ void Set3dmousePivotPos( const SFVEC3F& aPos ) { m_3dmousePivotPos = aPos; } /** * The actual function to repaint the canvas. * * It is usually called by OnPaint() but because it does not use a wxPaintDC it can be * called outside a wxPaintEvent */ void DoRePaint(); private: // The wxPaintEvent event. mainly calls DoRePaint() void OnPaint( wxPaintEvent& aEvent ); void OnEraseBackground( wxEraseEvent& event ); void OnRefreshRequest( wxEvent& aEvent ); void OnMouseWheel( wxMouseEvent& event ); void OnMagnify( wxMouseEvent& event ); void OnMouseMove( wxMouseEvent& event ); void OnLeftDown( wxMouseEvent& event ); void OnLeftUp( wxMouseEvent& event ); void OnMiddleUp( wxMouseEvent& event ); void OnMiddleDown( wxMouseEvent& event ); void OnTimerTimeout_Editing( wxTimerEvent& event ); void OnCloseWindow( wxCloseEvent& event ); void OnResize( wxSizeEvent& event ); void OnTimerTimeout_Redraw( wxTimerEvent& event ); DECLARE_EVENT_TABLE() /** *Stop the editing time so it will not timeout. */ void stop_editingTimeOut_Timer(); /** * Reset the editing timer. */ void restart_editingTimeOut_Timer(); /** * Start a camera movement. * * @param aMovingSpeed the time speed. * @param aRenderPivot if it should display pivot cursor while move. */ void request_start_moving_camera( float aMovingSpeed = 2.0f, bool aRenderPivot = true ); /** * This function hits a ray to the board and start a movement. */ void move_pivot_based_on_cur_mouse_position(); /** * Render the pivot cursor. * * @param t time between 0.0 and 1.0. * @param aScale scale to apply on the cursor. */ void render_pivot( float t, float aScale ); /** * Render the 3dmouse pivot cursor. * * @param aScale scale to apply on the cursor. */ void render3dmousePivot( float aScale ); /** * @return true if OpenGL initialization succeeded. */ bool initializeOpenGL(); /** * Free created targets and openGL context. */ void releaseOpenGL(); RAY getRayAtCurrentMousePosition(); private: TOOL_DISPATCHER* m_eventDispatcher; wxStatusBar* m_parentStatusBar; // Parent statusbar to report progress WX_INFOBAR* m_parentInfoBar; wxGLContext* m_glRC; // Current OpenGL context bool m_is_opengl_initialized; bool m_is_opengl_version_supported; wxTimer m_editing_timeout_timer; // Expires after some time signaling that // the mouse / keyboard movements are over wxTimer m_redraw_trigger_timer; // Used to schedule a redraw event std::atomic_flag m_is_currently_painting; // Avoid drawing twice at the same time bool m_render_pivot; // Render the pivot while camera moving float m_camera_moving_speed; // 1.0f will be 1:1 int64_t m_strtime_camera_movement; // Ticktime of camera movement start bool m_animation_enabled; // Camera animation enabled int m_moving_speed_multiplier; // Camera animation speed multiplier option BOARD_ADAPTER& m_boardAdapter; // Pre-computed 3D info and settings RENDER_3D_BASE* m_3d_render; RENDER_3D_RAYTRACE* m_3d_render_raytracing; RENDER_3D_OPENGL* m_3d_render_opengl; bool m_opengl_supports_raytracing; bool m_render_raytracing_was_requested; ACCELERATOR_3D* m_accelerator3DShapes; // used for mouse over searching BOARD_ITEM* m_currentRollOverItem; bool m_render3dmousePivot = false; // Render the 3dmouse pivot SFVEC3F m_3dmousePivotPos; // The position of the 3dmouse pivot /** * Trace mask used to enable or disable the trace output of this class. * The debug output can be turned on by setting the WXTRACE environment variable to * "KI_TRACE_EDA_3D_CANVAS". See the wxWidgets documentation on wxLogTrace for * more information. */ static const wxChar* m_logTrace; }; #endif // EDA_3D_CANVAS_H