class_docstr: A class whose objects contains image data, meta-data, and supports useful
  utility methods. This is intended to make image pre-processing easier for
  input into subsequent learning methods. Supports reading of JPEG and PNG
  formats.
  
  
  Parameters
  ----------
  
  path : string
      The path of the location of the image file to be loaded into the Image
      object.
  
  format : {'auto' | 'JPG' | 'PNG'}, optional
      Defaults to 'auto'. A format hint for the constructor. If left as
      'auto', constructor tries to infer file format from file extension.
      Otherwise, tries to decode file as whatever the format hint suggests.
  
  See Also
  --------
  turicreate.image_analysis.load_images
  turicreate.image_analysis.resize
  
  Examples
  --------
  >>> img = turicreate.Image('https://static.turi.com/datasets/images/sample.jpg')
  >>> turicreate.SArray([img]).show()
class_docstr_tok: ["A","class","whose","objects","contains","image","data",",","meta-data",",","and","supports","useful","utility","methods",".","This","is","intended","to","make","image","pre-processing","easier","for","input","into","subsequent","learning","methods",".","Supports","reading","of","JPEG","and","PNG","formats",".","Parameters","--","--","--","--","--","path",":","string","The","path","of","the","location","of","the","image","file","to","be","loaded","into","the","Image","object",".","format",":","{","'auto","'","|","'JPG","'","|","'PNG","'","}",",","optional","Defaults","to","'auto","'",".","A","format","hint","for","the","constructor",".","If","left","as","'auto","'",",","constructor","tries","to","infer","file","format","from","file","extension",".","Otherwise",",","tries","to","decode","file","as","whatever","the","format","hint","suggests",".","See","Also","--","--","--","--","turicreate.image_analysis.load_images","turicreate.image_analysis.resize","Examples","--","--","--","--",">",">",">","img","=","turicreate.Image","(","'https",":","\/\/static.turi.com\/datasets\/images\/sample.jpg","'",")",">",">",">","turicreate.SArray","(","[","img","]",")",".show","(",")"]
docstr: Displays the image.
  
  Alternatively, you can create an :class:`turicreate.SArray` of this image
  and use py:func:`turicreate.SArray.show()`
  
  See Also
  --------
  turicreate.image_analysis.resize
  
  Examples
  --------
  >>> img = turicreate.Image('https://static.turi.com/datasets/images/sample.jpg')
  >>> img.show()
docstr_tok: ["Displays","the","image",".","Alternatively",",","you","can","create","an",":","class",":","`","turicreate.SArray","`","of","this","image","and","use","py",":","func",":","`","turicreate.SArray.show","(",")","`","See","Also","--","--","--","--","turicreate.image_analysis.resize","Examples","--","--","--","--",">",">",">","img","=","turicreate.Image","(","'https",":","\/\/static.turi.com\/datasets\/images\/sample.jpg","'",")",">",">",">","img.show","(",")"]
code: def show(self):
      """
      Displays the image.
  
      Alternatively, you can create an :class:`turicreate.SArray` of this image
      and use py:func:`turicreate.SArray.show()`
  
      See Also
      --------
      turicreate.image_analysis.resize
  
      Examples
      --------
      >>> img = turicreate.Image('https://static.turi.com/datasets/images/sample.jpg')
      >>> img.show()
  
      """
      from ..visualization._plot import _target
  
      # Suppress visualization output if 'none' target is set
      if _target == "none":
          return
  
      try:
          img = self._to_pil_image()
          try:
              # output into jupyter notebook if possible
              if _target == "auto" and (
                  get_ipython().__class__.__name__
                  == "ZMQInteractiveShell"
                  or get_ipython().__class__.__name__ == "Shell"
              ):
                  from io import BytesIO
                  from IPython import display
  
                  b = BytesIO()
                  img.save(b, format="png")
                  data = b.getvalue()
                  ip_img = display.Image(
                      data=data, format="png", embed=True
                  )
                  display.display(ip_img)
              else:
                  # fall back to pillow .show (jupyter notebook integration disabled or not in jupyter notebook)
                  img.show()
          except NameError:
              # fall back to pillow .show (no get_ipython() available)
              img.show()
      except ImportError:
          print("Install pillow to use the .show() method.")
  
file_path: turicreate/src/python/turicreate/data_structures/image.py
imports: from __future__ import print_function
  from __future__ import division
  from __future__ import absolute_import
  from .._deps import numpy
label_desc: Use image node_id 13 for calling the Image obj's underlying member method code with example usage: obj.show() without return types