Examples

def set_camera_imageplane(
				filepath: str,
				colorspace: str='sRGB - Texture') -> str:
				
    """ カメラにイメージプレーンを設定 """
    _nodes = get_selected_nodes()

    if not _nodes:
        raise RuntimeError('Select any camera node')

    _camera = _nodes[0]

    # カメラのシェイプノードを取得
    _imageplane = cmds.listConnections(f'{_camera}.imagePlane', type='imagePlane')
    if _imageplane:
        _plane = _imageplane[0]

    else:
        _imageplane = cmds.imagePlane(camera=_camera)
        _plane = _imageplane[1]

    # Fileノードにテクスチャを設定
    cmds.setAttr(f'{_plane}.imageName', filepath, type='string')
    
    # --------------------------
    # Horizontal Fit
    # 0 None
    # 1 Fill
    # 2 Horzontal
    # 3 Vertical
    # 4 Both
    # --------------------------
    cmds.setAttr(f'{_plane}.fit', 2)
    cmds.setAttr(f'{_plane}.useFrameExtension', 1)

    if colorspace:
        cmds.setAttr(f'{_plane}.ignoreColorSpaceFileRules', 1)
        cmds.setAttr(f'{_plane}.colorSpace', colorspace, type='string')

    return _plane