---
title: "imageWithCGImage:scale:orientation:"
framework: uikit
role: symbol
role_heading: Type Method
path: "uikit/uiimage/imagewithcgimage:scale:orientation:"
---

# imageWithCGImage:scale:orientation:

Creates and returns an image object with the specified scale and orientation factors.

## Declaration

```occ
+ (UIImage *) imageWithCGImage:(CGImageRef) cgImage scale:(CGFloat) scale orientation:(UIImageOrientation) orientation;
```

## Parameters

- `cgImage`: The Quartz image object.
- `scale`: The scale factor to use when interpreting the image data. Specifying a scale factor of 1.0 results in an image whose size matches the pixel-based dimensions of the image. Applying a different scale factor changes the size of the image as reported by the doc://com.apple.uikit/documentation/UIKit/UIImage/size property.
- `orientation`: The orientation of the image data. You can use this parameter to specify any rotation factors applied to the image.

## Return Value

Return Value A new image object for the specified Quartz image, or nil if the method could not initialize the image from the specified image reference.

## Discussion

Discussion This method does not cache the image object. You can use the methods of the Core Graphics framework to create a Quartz image reference.

## See Also

### Creating and initializing image objects

- [imageWithContentsOfFile:](uikit/uiimage/imagewithcontentsoffile:.md)
- [imageWithData:](uikit/uiimage/imagewithdata:.md)
- [imageWithData:scale:](uikit/uiimage/imagewithdata:scale:.md)
- [imageWithCGImage:](uikit/uiimage/imagewithcgimage:.md)
- [imageWithCIImage:](uikit/uiimage/imagewithciimage:.md)
- [imageWithCIImage:scale:orientation:](uikit/uiimage/imagewithciimage:scale:orientation:.md)
- [init(contentsOfFile:)](uikit/uiimage/init(contentsoffile:).md)
- [init(data:)](uikit/uiimage/init(data:).md)
- [init(data:scale:)](uikit/uiimage/init(data:scale:).md)
- [init(cgImage:)](uikit/uiimage/init(cgimage:)-14qlb.md)
- [init(cgImage:scale:orientation:)](uikit/uiimage/init(cgimage:scale:orientation:)-2ouhh.md)
- [init(ciImage:)](uikit/uiimage/init(ciimage:)-93vu1.md)
- [init(ciImage:scale:orientation:)](uikit/uiimage/init(ciimage:scale:orientation:)-9gpyn.md)
- [UIImageReader](uikit/uiimagereader-c.class.md)
- [UIImageReaderConfiguration](uikit/uiimagereaderconfiguration.md)