Makrodefinicja: Umieść obraz

From FreeCAD Documentation
This page is a translated version of the page Macro Place Image and the translation is 100% complete.
Other languages:

Generic macro icon. Create your personal icon with the same name of the macro Macro Place Image

Opis
Tworzy płaszczyznę obrazu i wyrównuje ją do istniejącego prostokąta środowiska Kreślenie.

Macro version: 0.1
Last modified: 2023-01-30
Autor: heda
Autor
heda
Do pobrania
Nie określono
Odnosniki
Wersja Makrodefinicji
0.1
Data zmian
2023-01-30
Wersja FreeCAD
Nie określono
Domyślny skrót
Brak
Zobacz również
-

Opis

Tworzy płaszczyznę obrazu i wyrównuje ją do istniejącego prostokąta środowiska Kreślenie.

Użycie

Wybierz prostokąt środowiska Kreślenie, uruchom makro. Zobacz _dokumentację_, aby poznać ograniczenia.

Instalacja

Za pomocą Menedżera dodatków.

Odnośniki internetowe

Forum: Bez dedykowanego wątku, ale powstało z postu na forum.

Wersja

v0.1 2023-01-30 : pierwsze wydanie

Skrypt

Macro_Place_Image.FCMacro

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

# ***************************************************************************
# *   Copyright (c) 2023 heda <heda @ freecad forum>                        *
# *                                                                         *
# *   This file is part of the FreeCAD CAx development system.              *
# *                                                                         *
# *   This program is free software; you can redistribute it and/or modify  *
# *   it under the terms of the GNU Lesser General Public License (LGPL)    *
# *   as published by the Free Software Foundation; either version 2 of     *
# *   the License, or (at your option) any later version.                   *
# *   for detail see the LICENCE text file.                                 *
# *                                                                         *
# *   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 Library General Public License for more details.                  *
# *                                                                         *
# *   You should have received a copy of the GNU Library General Public     *
# *   License along with this program; if not, write to the Free Software   *
# *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  *
# *   USA                                                                   *
# *                                                                         *
# ***************************************************************************


__Name__ = 'Place_Image'
__Comment__ = 'Aligns ImagePlane to existing draft rectangle'
__Author__ = 'heda @ fc-forum'
__Version__ = '0.1'
__Date__ = '2023-01-30'
__License__ = 'LGPL-2.0-or-later'
__Web__ = ''
__Wiki__ = 'https://wiki.freecadweb.org/Macro_Place_Image'
__Icon__ = ''
__Help__ = 'Select rectangle, run macro and image is placed.'
__Status__ = 'Stable'
__Requires__ = 'tested on FreeCAD v0.20'
__Communication__ = 'forum'
__Files__ = ''


__doc__ = """
Works as intended on XY-plane.
When out of XY-plane, not so much.
Feel free to improve the placement logic.
"""


from pathlib import Path as pyPath
from PySide.QtGui import QMessageBox, QFileDialog

import Draft
import FreeCAD as App
import FreeCADGui as Gui

doc = App.ActiveDocument
sel = Gui.Selection.getSelection()
rect = None

def message(msg):
    QMessageBox.information(None, __Name__, msg)

if sel:
    sel, *_ = sel
    if hasattr(sel, 'Proxy') and isinstance(sel.Proxy, Draft.Rectangle):
        rect = sel
    else:
        message('Sorry, selected object needs to be a draft rectangle.')
else:
    message('No selection, select a draft rectangle.')

if rect:
    rname = rect.Name
    picformats = '*.png *.bmp *.jpg *.jpeg'
    pic, _ = QFileDialog.getOpenFileName(None, 'Select Image',
                                         '', f'Images ({picformats})')
    if pic:
        picname = pyPath(pic).stem.replace(' ', '_')
        imp = doc.addObject('Image::ImagePlane', picname)
        imp.ImageFile = pic

        imp.setExpression('XSize', f'{rname}.Length')
        imp.setExpression('YSize', f'{rname}.Height')
        imp.setExpression('.Placement.Base.x',
                          f'{rname}.Placement.Base.x + XSize / 2')
        imp.setExpression('.Placement.Base.y',
                          f'{rname}.Placement.Base.y + YSize / 2')
        imp.setExpression('.Placement.Base.z',
                          f'{rname}.Placement.Base.z - 0.1 mm')
        imp.setExpression('.Placement.Rotation.Angle',
                          f'{rname}.Placement.Rotation.Angle')
        imp.setExpression('.Placement.Rotation.Axis',
                          f'{rname}.Placement.Rotation.Axis')

        rect.ViewObject.Visibility = False
        rect.setExpression('.Label2',  f'<<{picname}>>')
        doc.recompute()
        print('placed image successfully')