Macros/Impress/004

Other languages:

Description

It is useful to be able to copy an attribute of a currently selected shape or object to the clipboard. To that end, it is quite useful to use Python, since it is easy to find and import a popular library for copying a string to the clipboard, which would be less trivial to do using functions or libraries of LibreOffice Basic. (Andrew Pitonyak's OOME book v3[1] does include an example of copying to clipboard in LO Basic on p. 267 though.)

In the below macro, the currently selected object is accessed using XSCRIPTCONTEXT.getDocument().CurrentSelection[0] i.e. the zeroth element of the array of selected objects. A shape such as a com.sun.star.drawing.RectangleShape will have the attribute FillColor[2]. The color is a single long integer, with the following mathematical definition:[3][4][5]

Color Value $\displaystyle{ =R*2^{16} + G*2^8 + B*2^0 }$

where $\displaystyle{ R,G,B }$ are 8-bit values (between 0-255) for red, green, blue. Hence, a function has to be created making use moduli and other mathematical operations to extract to the more conventional RGB standard and then to hex color code.

After accessing the FillColor attribute, the script makes use of the pyperclip[6] module for copying to clipboard. To install pyperclip, in run

pip3 install --user pyperclip

You may also need to add path of packages if LibreOffice does not find your pyperclip installation, for example as such:

import sys
sys.path.append('~/.local/lib/python3.8/site-packages/')
import pyperclip


Code

Python

# -*- coding: utf-8 -*-
import uno
from com.sun.star.awt import MessageBoxButtons as MSG_BUTTONS

#import sys
#sys.path.append('~/.local/lib/python3.8/site-packages/')
import pyperclip

def copy_hex_color(*args):      # Must include '*args' in func. definition
'''LO macro to extract the hex color of a selected shape's FillColor attribute to the clipboard.'''

thisComponent = XSCRIPTCONTEXT.getDocument()

try:
sel = thisComponent.CurrentSelection[0]   # get currently selected shape
hex_color = cval2hex(sel.FillColor)
pyperclip.copy(hex_color)
#msgbox( 'Copied "' + str(sel.FillColor) + '" as "' + pyperclip.paste() + '" !' )  # comment out for testing
except:
msgbox('Exception occured!')

def cval2hex(c):
'''Convert Color Value to hex.'''

# Extract 8-bit (0-255) RGB from Color Value
red   = ( c - c % 2**16 ) /2**16;
green = ( c % 2**16 - c % 2**8 ) /2**8;
blue  = ( c % 2**8 ) /2**0;

h = '#%02x%02x%02x' % (int(red), int(green), int(blue))  # RGB to hex

def rgb2cval(r,g,b):
'''Returns Color Value from 8-bit (0-255) RGB components'''
return (r * 2**16) + (g * 2**8) + (b * 2**0)

def msgbox(message, title='LibreOffice', buttons=MSG_BUTTONS.BUTTONS_OK, type_msg='infobox'):
'''https://wiki.documentfoundation.org/Macros/Python_Guide/Useful_functions#MsgBox'''
'''Create message box
type_msg: infobox, warningbox, errorbox, querybox, messbox
https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1XMessageBoxFactory.html
'''
toolkit = create_instance('com.sun.star.awt.Toolkit')
parent = toolkit.getDesktopWindow()
mb = toolkit.createMessageBox(parent, type_msg, buttons, title, str(message))
return mb.execute()

def create_instance(name, with_context=False):
'''https://wiki.documentfoundation.org/Macros/Python_Guide/Useful_functions#Create_instances'''
CTX = uno.getComponentContext()
SM = CTX.getServiceManager()
if with_context:
instance = SM.createInstanceWithContext(name, CTX)
else:
instance = SM.createInstance(name)
return instance

# Make it such that only the copy_hex_color function will be visible in navigation tree of LO macros
g_exportedScripts = (copy_hex_color,)


tbc