本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 取得影像集像素資料 [影像影格](getting-started-concepts.md#concept-image-frame)是影像集中存在以組成 2D 醫療影像的像素資料。使用 `GetImageFrame`動作來擷取 HealthImaging 中特定影像[集](getting-started-concepts.md#concept-image-set)的 HTJ2K-encoded或原生 JPEG 2000 無失真影像影格。下列功能表提供 AWS CLI 和 AWS SDKs程式碼範例。如需詳細資訊，請參閱《*AWS HealthImaging API 參考*[https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageFrame.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageFrame.html)》中的。 **注意** 使用 `GetImageFrame`動作時，請記住下列幾點：在[匯入](importing-imaging-data.md)期間，HealthImaging 會保留某些傳輸語法的編碼，並將其他語法轉碼為 HTJ2K 無損（預設）或 JPEG 2000 無損。`GetImageFrame` 動作會以執行個體的預存傳輸語法傳回影像影格。擷取期間不會執行轉碼，以確保擷取延遲降到最低。視傳輸語法而定，可能需要先解碼影像影格，才能在影像檢視器中檢視。如需詳細資訊，請參閱[支援的傳輸語法](supported-transfer-syntaxes.md)及[影像影格解碼程式庫](reference-libraries.md)。對於存放在 HealthImaging 中的執行個體，使用 MPEG 系列 Transfer Syntaxes （包括 MPEG2, MPEG-4 AVC/H.264 和 HEVC/H.265) 中編碼的一或多個影像影格，`GetImageFrame`動作將以[儲存的 Transfer Syntax ](supported-transfer-syntaxes.md)傳回視訊物件。映像影格的傳輸語法是在`Content-Type HTTP`標頭回應元素中指定。例如，以 HTJ2K 編碼的影像影格會有 `Content-Type: image/jph header`。如需詳細資訊，請參閱《*AWS HealthImaging API 參考*[https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageFrame.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageFrame.html)》中的。您也可以使用 `GetDICOMInstanceFrames` HealthImaging 的 DICOMweb 服務表示法，為與 DICOMweb 相容的檢視器和應用程式擷取 DICOM 執行個體影格 (`multipart` 請求）。如需詳細資訊，請參閱[從 HealthImaging 取得 DICOM 執行個體影格](dicomweb-retrieve-instance-frames.md)。 **取得影像集像素資料** 根據您對 AWS HealthImaging 的存取偏好設定，選擇選單。 ## AWS 主控台 **注意** 影像影格必須以程式設計方式存取和解碼，因為影像檢視器無法在中使用 AWS 管理主控台。如需解碼和檢視影像影格的詳細資訊，請參閱 [影像影格解碼程式庫](reference-libraries.md)。 ## AWS CLI 和 SDKs ------ #### [ C\$1\$1 ] **適用於 C\$1\$1 的 SDK** ``` //! Routine which downloads an AWS HealthImaging image frame. /*! \param dataStoreID: The HealthImaging data store ID. \param imageSetID: The image set ID. \param frameID: The image frame ID. \param jphFile: File to store the downloaded frame. \param clientConfig: Aws client configuration. \return bool: Function succeeded. */ bool AwsDoc::Medical_Imaging::getImageFrame(const Aws::String &dataStoreID, const Aws::String &imageSetID, const Aws::String &frameID, const Aws::String &jphFile, const Aws::Client::ClientConfiguration &clientConfig) { Aws::MedicalImaging::MedicalImagingClient client(clientConfig); Aws::MedicalImaging::Model::GetImageFrameRequest request; request.SetDatastoreId(dataStoreID); request.SetImageSetId(imageSetID); Aws::MedicalImaging::Model::ImageFrameInformation imageFrameInformation; imageFrameInformation.SetImageFrameId(frameID); request.SetImageFrameInformation(imageFrameInformation); Aws::MedicalImaging::Model::GetImageFrameOutcome outcome = client.GetImageFrame( request); if (outcome.IsSuccess()) { std::cout << "Successfully retrieved image frame." << std::endl; auto &buffer = outcome.GetResult().GetImageFrameBlob(); std::ofstream outfile(jphFile, std::ios::binary); outfile << buffer.rdbuf(); } else { std::cout << "Error retrieving image frame." << outcome.GetError().GetMessage() << std::endl; } return outcome.IsSuccess(); } ``` + 如需 API 詳細資訊，請參閱《適用於 C\$1\$1 的 AWS SDK API 參考》**中的 [GetImageFrame](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/GetImageFrame)。 GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples)中設定和執行。 ------ #### [ CLI ] **AWS CLI** **取得影像集像素資料** 下列 `get-image-frame` 程式碼範例會取得影像影格。 ``` aws medical-imaging get-image-frame \ --datastore-id "12345678901234567890123456789012" \ --image-set-id "98765412345612345678907890789012" \ --image-frame-information imageFrameId=3abf5d5d7ae72f80a0ec81b2c0de3ef4 \ imageframe.jph ``` 注意：此程式碼範例不包含輸出，因為 GetImageFrame 動作會將像素資料串流傳回至 imageframe.jph 檔案。如需解碼和檢視影像影格的資訊，請參閱 HTJ2K 解碼程式庫。如需詳細資訊，請參閱《*AWS HealthImaging 開發人員指南*》中的[取得影像集像素資料](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-frame.html)。 + 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetImageFrame](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-frame.html)。 ------ #### [ Java ] **適用於 Java 2.x 的 SDK** ``` public static void getMedicalImageSetFrame(MedicalImagingClient medicalImagingClient, String destinationPath, String datastoreId, String imagesetId, String imageFrameId) { try { GetImageFrameRequest getImageSetMetadataRequest = GetImageFrameRequest.builder() .datastoreId(datastoreId) .imageSetId(imagesetId) .imageFrameInformation(ImageFrameInformation.builder() .imageFrameId(imageFrameId) .build()) .build(); medicalImagingClient.getImageFrame(getImageSetMetadataRequest, FileSystems.getDefault().getPath(destinationPath)); System.out.println("Image frame downloaded to " + destinationPath); } catch (MedicalImagingException e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } } ``` + 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [GetImageFrame](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetImageFrame)。 GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples)中設定和執行。 ------ #### [ JavaScript ] **適用於 JavaScript (v3) 的 SDK** ``` import { GetImageFrameCommand } from "@aws-sdk/client-medical-imaging"; import { medicalImagingClient } from "../libs/medicalImagingClient.js"; /** * @param {string} imageFrameFileName - The name of the file for the HTJ2K-encoded image frame. * @param {string} datastoreID - The data store's ID. * @param {string} imageSetID - The image set's ID. * @param {string} imageFrameID - The image frame's ID. */ export const getImageFrame = async ( imageFrameFileName = "image.jph", datastoreID = "DATASTORE_ID", imageSetID = "IMAGE_SET_ID", imageFrameID = "IMAGE_FRAME_ID", ) => { const response = await medicalImagingClient.send( new GetImageFrameCommand({ datastoreId: datastoreID, imageSetId: imageSetID, imageFrameInformation: { imageFrameId: imageFrameID }, }), ); const buffer = await response.imageFrameBlob.transformToByteArray(); writeFileSync(imageFrameFileName, buffer); console.log(response); // { // '$metadata': { // httpStatusCode: 200, // requestId: 'e4ab42a5-25a3-4377-873f-374ecf4380e1', // extendedRequestId: undefined, // cfId: undefined, // attempts: 1, // totalRetryDelay: 0 // }, // contentType: 'application/octet-stream', // imageFrameBlob: IncomingMessage {} // } return response; }; ``` + 如需 API 詳細資訊，請參閱《適用於 JavaScript 的 AWS SDK API 參考》**中的 [GetImageFrame](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetImageFrameCommand)。 GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples)中設定和執行。 ------ #### [ Python ] **適用於 Python 的 SDK (Boto3)** ``` class MedicalImagingWrapper: def __init__(self, health_imaging_client): self.health_imaging_client = health_imaging_client def get_pixel_data( self, file_path_to_write, datastore_id, image_set_id, image_frame_id ): """ Get an image frame's pixel data. :param file_path_to_write: The path to write the image frame's HTJ2K encoded pixel data. :param datastore_id: The ID of the data store. :param image_set_id: The ID of the image set. :param image_frame_id: The ID of the image frame. """ try: image_frame = self.health_imaging_client.get_image_frame( datastoreId=datastore_id, imageSetId=image_set_id, imageFrameInformation={"imageFrameId": image_frame_id}, ) with open(file_path_to_write, "wb") as f: for chunk in image_frame["imageFrameBlob"].iter_chunks(): if chunk: f.write(chunk) except ClientError as err: logger.error( "Couldn't get image frame. Here's why: %s: %s", err.response["Error"]["Code"], err.response["Error"]["Message"], ) raise ``` 下列程式碼會執行個體化 MedicalImagingWrapper 物件。 ``` client = boto3.client("medical-imaging") medical_imaging_wrapper = MedicalImagingWrapper(client) ``` + 如需 API 詳細資訊，請參閱《AWS SDK for Python (Boto3) API 參考》**中的 [GetImageFrame](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetImageFrame)。 GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples)中設定和執行。 ------ #### [ SAP ABAP ] **適用於 SAP ABAP 的開發套件** ``` TRY. " iv_datastore_id = '1234567890123456789012345678901234567890' " iv_image_set_id = '1234567890123456789012345678901234567890' " iv_image_frame_id = '1234567890123456789012345678901234567890' oo_result = lo_mig->getimageframe( iv_datastoreid = iv_datastore_id iv_imagesetid = iv_image_set_id io_imageframeinformation = NEW /aws1/cl_migimageframeinfmtion( iv_imageframeid = iv_image_frame_id ) ). DATA(lv_frame_blob) = oo_result->get_imageframeblob( ). MESSAGE 'Image frame retrieved.' TYPE 'I'. CATCH /aws1/cx_migaccessdeniedex. MESSAGE 'Access denied.' TYPE 'I'. CATCH /aws1/cx_migconflictexception. MESSAGE 'Conflict error.' TYPE 'I'. CATCH /aws1/cx_miginternalserverex. MESSAGE 'Internal server error.' TYPE 'I'. CATCH /aws1/cx_migresourcenotfoundex. MESSAGE 'Image frame not found.' TYPE 'I'. CATCH /aws1/cx_migthrottlingex. MESSAGE 'Request throttled.' TYPE 'I'. CATCH /aws1/cx_migvalidationex. MESSAGE 'Validation error.' TYPE 'I'. ENDTRY. ``` + 如需 API 詳細資訊，請參閱《適用於 *AWS SAP ABAP 的 SDK API 參考*》中的 [GetImageFrame](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)。 GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples)中設定和執行。 ------ **可用性範例** 找不到所需的內容嗎？使用此頁面右側的**提供意見回饋**連結來請求程式碼範例。