class_docstr: Container for all keypoints on a single image.
  
  Parameters
  ----------
  keypoints : list of imgaug.augmentables.kps.Keypoint
      List of keypoints on the image.
  
  shape : tuple of int
      The shape of the image on which the objects are placed, i.e. the
      result of ``image.shape``.
      Should include the number of channels, not only height and width.
  
  Examples
  --------
  >>> import numpy as np
  >>> from imgaug.augmentables.kps import Keypoint, KeypointsOnImage
  >>>
  >>> image = np.zeros((70, 70))
  >>> kps = [Keypoint(x=10, y=20), Keypoint(x=34, y=60)]
  >>> kps_oi = KeypointsOnImage(kps, shape=image.shape)
class_docstr_tok: ["Container","for","all","keypoints","on","a","single","image",".","Parameters","--","--","--","--","--","keypoints",":","list","of","imgaug.augmentables.kps.Keypoint","List","of","keypoints","on","the","image",".","shape",":","tuple","of","int","The","shape","of","the","image","on","which","the","objects","are","placed",",","i.e",".","the","result","of","``","image.shape","``",".","Should","include","the","number","of","channels",",","not","only","height","and","width",".","Examples","--","--","--","--",">",">",">","import","numpy","as","np",">",">",">","from","imgaug.augmentables.kps","import","Keypoint",",","KeypointsOnImage",">",">",">",">",">",">","image","=","np.zeros","(","(","70",",","70",")",")",">",">",">","kps","=","[","Keypoint","(","x=10",",","y=20",")",",","Keypoint","(","x=34",",","y=60",")","]",">",">",">","kps_oi","=","KeypointsOnImage","(","kps",",","shape=image.shape",")"]
docstr: Draw all keypoints onto a given image.
  
  Each keypoint is drawn as a square of provided color and size.
  
  Parameters
  ----------
  image : (H,W,3) ndarray
      The image onto which to draw the keypoints.
      This image should usually have the same shape as
      set in ``KeypointsOnImage.shape``.
  
  color : int or list of int or tuple of int or (3,) ndarray, optional
      The RGB color of all keypoints.
      If a single ``int`` ``C``, then that is equivalent to ``(C,C,C)``.
  
  alpha : float, optional
      The opacity of the drawn keypoint, where ``1.0`` denotes a fully
      visible keypoint and ``0.0`` an invisible one.
  
  size : int, optional
      The size of each point. If set to ``C``, each square will have
      size ``C x C``.
  
  copy : bool, optional
      Whether to copy the image before drawing the points.
  
  raise_if_out_of_image : bool, optional
      Whether to raise an exception if any keypoint is outside of the
      image.
  
  Returns
  -------
  (H,W,3) ndarray
      Image with drawn keypoints.
docstr_tok: ["Draw","all","keypoints","onto","a","given","image",".","Each","keypoint","is","drawn","as","a","square","of","provided","color","and","size",".","Parameters","--","--","--","--","--","image",":","(","H",",","W,3",")","ndarray","The","image","onto","which","to","draw","the","keypoints",".","This","image","should","usually","have","the","same","shape","as","set","in","``","KeypointsOnImage.shape","``",".","color",":","int","or","list","of","int","or","tuple","of","int","or","(","3",",",")","ndarray",",","optional","The","RGB","color","of","all","keypoints",".","If","a","single","``","int","``","``","C","``",",","then","that","is","equivalent","to","``","(","C",",","C",",","C",")","``",".","alpha",":","float",",","optional","The","opacity","of","the","drawn","keypoint",",","where","``","1.0","``","denotes","a","fully","visible","keypoint","and","``","0.0","``","an","invisible","one",".","size",":","int",",","optional","The","size","of","each","point",".","If","set","to","``","C","``",",","each","square","will","have","size","``","C","x","C","``",".","copy",":","bool",",","optional","Whether","to","copy","the","image","before","drawing","the","points",".","raise_if_out_of_image",":","bool",",","optional","Whether","to","raise","an","exception","if","any","keypoint","is","outside","of","the","image",".","Returns","--","--","--","-","(","H",",","W,3",")","ndarray","Image","with","drawn","keypoints","."]
code: def draw_on_image(
      self,
      image,
      color=(0, 255, 0),
      alpha=1.0,
      size=3,
      copy=True,
      raise_if_out_of_image=False,
  ):
      """Draw all keypoints onto a given image.
  
      Each keypoint is drawn as a square of provided color and size.
  
      Parameters
      ----------
      image : (H,W,3) ndarray
          The image onto which to draw the keypoints.
          This image should usually have the same shape as
          set in ``KeypointsOnImage.shape``.
  
      color : int or list of int or tuple of int or (3,) ndarray, optional
          The RGB color of all keypoints.
          If a single ``int`` ``C``, then that is equivalent to ``(C,C,C)``.
  
      alpha : float, optional
          The opacity of the drawn keypoint, where ``1.0`` denotes a fully
          visible keypoint and ``0.0`` an invisible one.
  
      size : int, optional
          The size of each point. If set to ``C``, each square will have
          size ``C x C``.
  
      copy : bool, optional
          Whether to copy the image before drawing the points.
  
      raise_if_out_of_image : bool, optional
          Whether to raise an exception if any keypoint is outside of the
          image.
  
      Returns
      -------
      (H,W,3) ndarray
          Image with drawn keypoints.
  
      """
      # pylint: disable=redefined-outer-name
      image = np.copy(image) if copy else image
      for keypoint in self.keypoints:
          image = keypoint.draw_on_image(
              image,
              color=color,
              alpha=alpha,
              size=size,
              copy=False,
              raise_if_out_of_image=raise_if_out_of_image,
          )
      return image
  
imports: from __future__ import print_function, division, absolute_import
  import numpy
  import scipy.spatial.distance
  import six.moves
  from ..None import imgaug
  from .base import IAugmentable
  from .utils import normalize_imglike_shape, project_coords, _remove_out_of_image_fraction_, _handle_on_image_shape
label_desc: Use image node_id 9 for calling the KeypointsOnImage obj's underlying member method code with example usage: obj.draw_on_image(image, color, alpha, size, copy, raise_if_out_of_image) and returns: image