Source code for ginga.canvas.CompoundMixin

#
# CompoundMixin.py -- enable compound capabilities.
#
# This is open-source software licensed under a BSD license.
# Please see the file LICENSE.txt for details.
#
from functools import reduce

import numpy as np

__all__ = ['CompoundMixin']


[docs] class CompoundMixin(object): """A CompoundMixin is a mixin class that makes an object that is an aggregation of other objects. It is used to make generic compound drawing types as well as (for example) layers of canvases on top of an image. """ def __init__(self): # holds a list of objects to be drawn self.objects = [] if not hasattr(self, 'crdmap'): self.crdmap = None if not hasattr(self, 'coord'): self.coord = None self.opaque = False self._contains_reduce = np.logical_or def __contains__(self, key): return key in self.objects def __len__(self): return len(self.objects)
[docs] def get_llur(self): """ Get lower-left and upper-right coordinates of the bounding box of this compound object. Returns ------- x1, y1, x2, y2: a 4-tuple of the lower-left and upper-right coords """ points = np.array([obj.get_llur() for obj in self.objects]) t_ = points.T x1, y1 = t_[0].min(), t_[1].min() x2, y2 = t_[2].max(), t_[3].max() return (x1, y1, x2, y2)
[docs] def contains_pts(self, pts): if len(self.objects) == 0: x_arr, y_arr = np.asarray(pts).T return np.full(x_arr.shape, False, dtype=bool) return reduce(self._contains_reduce, map(lambda obj: obj.contains_pts(pts), self.objects))
[docs] def get_items_at(self, pt): res = [] for obj in self.objects: if obj.is_compound() and not obj.opaque: # non-opaque compound object, list up compatible members res.extend(obj.get_items_at(pt)) elif obj.contains_pt(pt): #res.insert(0, obj) res.append(obj) return res
[docs] def get_objects_by_kind(self, kind): return filter(lambda obj: obj.kind == kind, self.objects)
[docs] def get_objects_by_kinds(self, kinds): return filter(lambda obj: obj.kind in kinds, self.objects)
[docs] def select_contains_pt(self, viewer, pt): for obj in self.objects: if obj.select_contains_pt(viewer, pt): return True return False
[docs] def select_items_at(self, viewer, pt, test=None): res = [] try: for obj in self.objects: if obj.is_compound() and not obj.opaque: # non-opaque compound object, list up compatible members res.extend(obj.select_items_at(viewer, pt, test=test)) is_inside = obj.select_contains_pt(viewer, pt) if test is None: if is_inside: res.append(obj) elif test(obj, pt, is_inside): # custom test res.append(obj) except Exception as e: self.logger.error("error selecting object(s): {}".format(e), exc_info=True) res = [] return res
[docs] def initialize(self, canvas, viewer, logger): super().initialize(canvas, viewer, logger) # initialize children for obj in self.objects: obj.initialize(self, viewer, logger)
[docs] def inherit_from(self, obj): self.crdmap = obj.crdmap self.logger = obj.logger self.viewer = obj.viewer
[docs] def is_compound(self): return True
[docs] def use_coordmap(self, mapobj): super().use_coordmap(mapobj) for obj in self.objects: obj.use_coordmap(mapobj)
[docs] def draw(self, viewer): for obj in self.objects: obj.draw(viewer)
[docs] def get_objects(self): return self.objects
[docs] def has_object(self, obj): return obj in self.objects
[docs] def copy(self, share=[]): obj = super().copy(share=share) obj.objects = [obj.copy(share=share) for obj in self.objects] return obj
[docs] def delete_object(self, obj): self.objects.remove(obj)
[docs] def delete_objects(self, objects): for obj in objects: self.delete_object(obj)
[docs] def delete_all_objects(self): self.objects.clear()
[docs] def roll_objects(self, n): num = len(self.objects) if num == 0: return n = n % num self.objects = self.objects[-n:] + self.objects[:-n]
[docs] def swap_objects(self): num = len(self.objects) if num >= 2: l = self.objects self.objects = l[:num - 2] + [l[num - 1], l[num - 2]]
[docs] def set_attr_all(self, **kwdargs): for obj in self.objects: for attrname, val in kwdargs.items(): if hasattr(obj, attrname): setattr(obj, attrname, val)
[docs] def add_object(self, obj, belowThis=None): if obj in self.objects: raise ValueError("object is already in this compound object") obj.initialize(self, self.viewer, self.logger) if belowThis is None: self.objects.append(obj) else: index = self.objects.index(belowThis) self.objects.insert(index, obj)
[docs] def raise_object(self, obj, aboveThis=None): if aboveThis is None: # no reference object--move to top self.objects.remove(obj) self.objects.append(obj) else: # Force an error if the reference object doesn't exist in list index = self.objects.index(aboveThis) self.objects.remove(obj) index = self.objects.index(aboveThis) self.objects.insert(index + 1, obj)
[docs] def lower_object(self, obj, belowThis=None): if belowThis is None: # no reference object--move to bottom self.objects.remove(obj) self.objects.insert(0, obj) else: # Force an error if the reference object doesn't exist in list index = self.objects.index(belowThis) self.objects.remove(obj) index = self.objects.index(belowThis) self.objects.insert(index, obj)
[docs] def rotate_deg(self, thetas, offset): for obj in self.objects: obj.rotate_deg(thetas, offset)
[docs] def move_delta_pt(self, off_pt): for obj in self.objects: obj.move_delta_pt(off_pt)
[docs] def scale_by_factors(self, factors): for obj in self.objects: obj.scale_by_factors(factors)
[docs] def get_reference_pt(self): # Reference point for a compound object is the average of all # it's contituents reference points points = np.asarray([obj.get_reference_pt() for obj in self.objects]) t_ = points.T x, y = np.average(t_[0]), np.average(t_[1]) return (x, y)
get_center_pt = get_reference_pt
[docs] def get_points(self): res = [] for obj in self.objects: res.extend(list(obj.get_points())) return res
[docs] def setup_edit(self, detail): detail.center_pos = self.get_center_pt()
[docs] def get_edit_points(self, viewer): move_pt, scale_pt, rotate_pt = self.get_move_scale_rotate_pts(viewer) # currently only move_pt is supported for compound objects return [move_pt]
[docs] def set_edit_point(self, i, pt, detail): if i == 0: # move control point ctr_x, ctr_y = self.get_reference_pt() delta_pt = (pt[0] - ctr_x, pt[1] - ctr_y) self.move_delta_pt(delta_pt) else: raise ValueError("No point corresponding to index %d" % (i))