First draft of crop hints

Author: ryanmats

vision/api/src/DetectCropHintsCommand.php

@@ -0,0 +1,71 @@
+<?php
+/**
+ * Copyright 2016 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+
+namespace Google\Cloud\Samples\Vision;
+
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Command line utility to detect which language some text is written in.
+ */
+class DetectCropHintsCommand extends Command
+{
+    protected function configure()
+    {
+        $this
+            ->setName('crop-hints')
+            ->setDescription('Detect crop hints in an image using '
+                . 'Google Cloud Vision API')
+            ->setHelp(<<<EOF
+The <info>%command.name%</info> command prints crop hints for an image using
+the Google Cloud Vision API.
+
+    <info>php %command.full_name% -k YOUR-API-KEY path/to/image.png</info>
+
+EOF
+            )
+            ->addArgument(
+                'path',
+                InputArgument::REQUIRED,
+                'The image to examine.'
+            )
+            ->addOption(
+                'project',
+                'p',
+                InputOption::VALUE_REQUIRED,
+                'Your Project ID.'
+            )
+        ;
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $projectId = $input->getOption('project');
+        $path = $input->getArgument('path');
+        if (preg_match('/^gs:\/\/([a-z0-9\._\-]+)\/(\S+)$/', $path, $matches)) {
+            list($bucketName, $objectName) = array_slice($matches, 1);
+            $result = require __DIR__ . '/snippets/detect_crop_hints_gcs.php';
+        } else {
+            $result = require __DIR__ . '/snippets/detect_crop_hints.php';
+        }
+    }
+}

vision/api/src/snippets/detect_crop_hints.php

@@ -0,0 +1,41 @@
+<?php
+/**
+ * Copyright 2016 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+namespace Google\Cloud\Samples\Vision;
+
+// [START vision_crop_hint_detection]
+use Google\Cloud\Vision\VisionClient;
+
+// $projectId = 'YOUR_PROJECT_ID';
+// $path = 'path/to/your/image.jpg'
+
+$vision = new VisionClient([
+    'projectId' => $projectId,
+]);
+$image = $vision->image(file_get_contents($path), ['CROP_HINTS']);
+$result = $vision->annotate($image);
+print("Crop Hints:\n");
+foreach ((array) $result->cropHints() as $hint) {
+    $boundingPoly = $hint->boundingPoly();
+    $vertices = $boundingPoly['vertices'];
+    foreach ((array) $vertices as $vertice) {
+        if (!isset($vertice['x'])) $vertice['x'] = 0;
+        if (!isset($vertice['y'])) $vertice['y'] = 0;
+        print('X: ' . $vertice['x'] . ' Y: ' . $vertice['y'] . PHP_EOL);
+    }
+}
+// [END vision_crop_hint_detection]

vision/api/vision.php

@@ -27,4 +27,5 @@
 $application->add(new Google\Cloud\Samples\Vision\DetectLogoCommand());
 $application->add(new Google\Cloud\Samples\Vision\DetectSafeSearchCommand());
 $application->add(new Google\Cloud\Samples\Vision\DetectImagePropertyCommand());
+$application->add(new Google\Cloud\Samples\Vision\DetectCropHintsCommand());
 $application->run();